PlatformAdaptor_Abstract.h

/***************************************************************************
 *   Copyright (C) 2019-2025 by Stefan Kebekus                             *
 *   stefan.kebekus@gmail.com                                              *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 3 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   This program is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 *   GNU General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program; if not, write to the                         *
 *   Free Software Foundation, Inc.,                                       *
 *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
 ***************************************************************************/
 
#pragma once
 
#include <QGeoCoordinate>
#include <QMarginsF>
#include <QQmlEngine>
#include <QQuickItem>
 
#include "GlobalObject.h"
#include "traffic/ConnectionInfo.h"
 
 
namespace Platform {

 
class PlatformAdaptor_Abstract : public GlobalObject
{
    Q_OBJECT
 
public:
    explicit PlatformAdaptor_Abstract(QObject* parent = nullptr);
 
    ~PlatformAdaptor_Abstract() override = default;
 
 
    //
    // Properties
    //

    Q_PROPERTY(QMarginsF safeInsets READ safeInsets NOTIFY safeInsetsChanged)
 
 
    //
    // Getter Methods
    //
 
    
    [[nodiscard]] virtual QMarginsF safeInsets() const { return {}; }
 
 
    //
    // Methods
    //

    Q_INVOKABLE static QString clipboardText();

    Q_INVOKABLE static bool setClipboardText(const QString& text);

    Q_INVOKABLE virtual QString currentSSID() { return {}; }

    Q_INVOKABLE virtual void disableScreenSaver() {}

    Q_INVOKABLE virtual void lockWifi(bool lock) { Q_UNUSED(lock) }

    Q_INVOKABLE virtual void openSatView(const QGeoCoordinate& coordinate);

    Q_INVOKABLE virtual void setupInputMethodEventFilter(QQuickItem* item) { Q_UNUSED(item) }

    Q_INVOKABLE virtual QString versionNameForDisplay();

    Q_INVOKABLE virtual QString systemInfo();

    Q_INVOKABLE virtual void vibrateBrief() {}

    Q_INVOKABLE virtual void vibrateLong() {}

    Q_INVOKABLE virtual QString language();

    Q_INVOKABLE static void saveScreenshot(const QImage& image, const QString& path);

    virtual QVector<Traffic::ConnectionInfo> serialPortConnectionInfos();
 
public slots:
    virtual void onGUISetupCompleted() {}
 
 
signals:
    void safeInsetsChanged();

    void error(const QString& message);

    void languageChanged();

    void wifiConnected();

    void serialPortsChanged();
 
private:
    Q_DISABLE_COPY_MOVE(PlatformAdaptor_Abstract)
 
};
 
} // namespace Platform