PointWidget.h

Go to the documentation of this file.

/*--------------------------------------------------------------------------------------------
Copyright (c) 2019, NDEVR LLC
tyler.parke@ndevr.org
  __    __   ____     _____ __     __  _______
 |  \  |  | |  __ \  |  ___|\ \   / / |   __  \
 |   \ |  | | |  \ \ | |___  \ \ / /  |  |__)  |
 |  . \|  | | |__/ / | |___   \ V /   |   _   /
 |  |\    |_|_____/__|_____|___\_/____|  | \  \
 |__| \__________________________________|  \__\
 
Subject to the terms of the Enterprise+ Agreement, NDEVR hereby grants 
Licensee a limited, non-exclusive, non-transferable, royalty-free license 
(without the right to sublicense) to use the API solely for the purpose of 
Licensee's internal development efforts to develop applications for which 
the API was provided.
 
The above copyright notice and this permission notice shall be included in all 
copies or substantial portions of the Software.
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.
 
Library: NDEVR
File: PointWidget
Included in API: True
Author(s): Tyler Parke
 *-----------------------------------------------------------------------------------------**/
#pragma once
#include "DLLInfo.h"
#include <NDEVR/QTTools.h>
#include <NDEVR/Vertex.h>
#include <NDEVR/Unit.h>
#include <NDEVR/Pointer.h>
#include <NDEVR/Matrix.h>
#include <QPointer>
namespace Ui
{
    class PointWidgetUI;
}
class QGridLayout;
namespace NDEVR
{
    class QCustomLabel;
    class QCustomLineEdit;
    class DimensionWidgets;
    class GNSSCallback;
    
    /**--------------------------------------------------------------------------------------------------
    \brief Allows the user to input an N-dimensional point (up to 4 dimensions) with an optinal unit.
        Also allows other widgets, such as a GNSS take reading button, to be added into the layout.
    **/
    class NDEVR_WIDGETS_API PointWidget : public QWidget
    {
        Q_OBJECT
    private:
        class PreTransform;
    public:
        class GNSSCallback
        {
        public:
            virtual QWidget* createGNSSWidget(UUID gps_name, PointWidget* point_widget) = 0;
        };
        PointWidget(QWidget* parent = nullptr);
        void setDimensionCount(uint01 dim_count);
        void setUnitToApplicationSpatialUnit();
        void setUnitToApplicationOrientationUnit();
        void setUnitToApplicationAngleUnit();
        void setUnitToApplicationDistanceUnit();
        void setEditable(bool editable);
        void setMinPoint(const Vertex<3, fltp08>& point);
        void setMaxPoint(const Vertex<3, fltp08>& point);
        void setStep(fltp08 step);
        void setUseLabelAbreviation(bool use_label_abv);
        void setFontMultiplier(fltp04 size_mult);
        void setPoint(Vertex<2, fltp08> point);
        void setPoint(Vertex<3, fltp08> point);
        void setPoint(Vertex<4, fltp08> point);
        void setDefaultPoint(const Vertex<3, fltp08>& point);
        void setUnit(const ConstPointer<Unit>& unit);
        const ConstPointer<Unit>& unit() const;
        void setTransform(const Matrix<fltp08>& mat);
        void setLabel(uint01 dimension, const TranslatedString& label);
        void setSurveySettings(QWidget* survey_settings);
        void setDecimalCount(uint04 count);
        Vertex<3, fltp08> calculatePoint() const;
        Vertex<3, fltp08> getPoint() const;
        Vertex<3, fltp08> placeholderPoint() const;
        void setNumberOfLines(uint04 line_count);
        bool isDefault() const;
        void setPreTransform(PreTransform* transform); 
        QPointer<QWidget> surveySettings() const { return m_survey_settings; }
    signals:
        void edited2();
        void editingFinished();
        void surveySettingsRequested();
    protected slots:
        void onUpdatedSlot();
        void onFinishedSlot();
    protected:
        class PreTransform
        {
        public:
            virtual void preTransform(Vertex<3, fltp08>& point) = 0;
            virtual void postTransform(Vertex<3, fltp08>& point) = 0;
            virtual bool isValid() const = 0;
        };
        void setRawUnit(const ConstPointer<Unit>& unit);
    private:
        void refreshLayout();
    protected:
        QTResourceListener* m_default_units_listener;
        Matrix<fltp08> m_matrix;
        ConstPointer<Unit> m_unit;
        Vertex<3, fltp08> m_point;
        fltp08 m_w_point;
        Vertex<3, fltp08> m_default_point;
        Vector<4, TranslatedString> m_custom_labels;
        Vector<4, DimensionWidgets*> m_dimension_widgets;
        uint01 m_dimension_count;
        uint04 m_layout_line_count;
        QGridLayout* m_layout;
        PreTransform* m_pre_transform = nullptr;
        QPointer<QWidget> m_survey_settings = nullptr;
        bool m_use_label_abv;
    };
}