cvSelectionToolController.h

Go to the documentation of this file.

// ----------------------------------------------------------------------------
// -                        CloudViewer: www.cloudViewer.org                  -
// ----------------------------------------------------------------------------
// Copyright (c) 2018-2024 www.cloudViewer.org
// SPDX-License-Identifier: MIT
// ----------------------------------------------------------------------------
 
#pragma once
 
// Qt - must be included before other headers for MOC to work correctly
#include <QtGlobal>
 
// clang-format off
#if QT_VERSION >= QT_VERSION_CHECK(6, 0, 0)
#include <QActionGroup>
#include <QMap>
#include <QObject>
#include <QPointer>
#else
#include <QtWidgets/QActionGroup>
#include <QtCore/QMap>
#include <QtCore/QObject>
#include <QtCore/QPointer>
#endif
// clang-format on
 
#include "cvSelectionData.h"  // Contains SelectionMode, SelectionModifier enums  // For SelectionMode and SelectionModifier enums
#include "cvViewSelectionManager.h"
#include "qPCL.h"
 
class QAction;
class QMenu;
class QToolBar;
class cvRenderViewSelectionReaction;
class cvSelectionData;
class cvSelectionHighlighter;
class cvSelectionHistory;
class cvSelectionBookmarks;
class ecvGenericVisualizer3D;
 
class QPCL_ENGINE_LIB_API cvSelectionToolController : public QObject {
    Q_OBJECT
 
public:
    using SelectionMode = ::SelectionMode;
    using SelectionModifier = ::SelectionModifier;
 
    static cvSelectionToolController* instance();
 
    void initialize(QWidget* parent);
 
    void setVisualizer(ecvGenericVisualizer3D* viewer);
 
    template <typename UiType>
    void setupActions(UiType* ui);
 
    static bool isPCLBackendAvailable();
 
    struct SelectionActions {
        // Surface selection
        QAction* selectSurfaceCells = nullptr;
        QAction* selectSurfacePoints = nullptr;
 
        // Frustum selection
        QAction* selectFrustumCells = nullptr;
        QAction* selectFrustumPoints = nullptr;
 
        // Polygon selection
        QAction* selectPolygonCells = nullptr;
        QAction* selectPolygonPoints = nullptr;
 
        // Block selection
        QAction* selectBlocks = nullptr;
        QAction* selectFrustumBlocks = nullptr;
 
        // Interactive selection
        QAction* interactiveSelectCells = nullptr;
        QAction* interactiveSelectPoints = nullptr;
 
        // Hover/tooltip selection
        QAction* hoverCells = nullptr;
        QAction* hoverPoints = nullptr;
 
        // Selection modifiers
        QAction* addSelection = nullptr;
        QAction* subtractSelection = nullptr;
        QAction* toggleSelection = nullptr;
 
        // Selection manipulation
        QAction* growSelection = nullptr;
        QAction* shrinkSelection = nullptr;
        QAction* clearSelection = nullptr;
 
        // Zoom to box
        QAction* zoomToBox = nullptr;
    };
 
    void setupActions(const SelectionActions& actions);
 
    void connectHighlighter();
 
    QObject* getPropertiesDelegate() const { return m_propertiesDelegate; }
 
    void setPropertiesDelegate(QObject* delegate) {
        m_propertiesDelegate = delegate;
    }
 
    cvRenderViewSelectionReaction* registerAction(QAction* action,
                                                  SelectionMode mode);
 
    void registerModifierActions(QAction* addAction,
                                 QAction* subtractAction,
                                 QAction* toggleAction);
 
    void registerManipulationActions(QAction* growAction,
                                     QAction* shrinkAction,
                                     QAction* clearAction);
 
    void disableAllTools(cvRenderViewSelectionReaction* except = nullptr);
 
    bool isAnyToolActive() const;
 
    SelectionMode currentMode() const;
 
    bool handleEscapeKey();
 
    cvViewSelectionManager* manager() const { return m_manager; }
 
    cvSelectionHighlighter* highlighter() const;
 
    // history() removed - UI not implemented
 
    void setSelectionPropertiesActive(bool active);
 
    void invalidateCache();
 
signals:
    void selectionFinished(const cvSelectionData& selectionData);
 
    void selectionToolStateChanged(bool anyToolActive);
 
    void selectionPropertiesUpdateRequested(
            const cvSelectionData& selectionData);
 
    void selectionHistoryChanged();
 
    void bookmarksChanged();
 
    void zoomToBoxRequested(int xmin, int ymin, int xmax, int ymax);
 
public slots:
    void onSelectionFinished(const cvSelectionData& selectionData);
 
    // undoSelection/redoSelection removed - UI not implemented
 
    void onModifierChanged(QAction* action);
 
    // Note: onTooltipSettingsChanged has been removed as tooltip settings
    // are now managed through cvSelectionLabelPropertiesDialog
 
private:
    explicit cvSelectionToolController(QObject* parent = nullptr);
    ~cvSelectionToolController() override;
 
    Q_DISABLE_COPY(cvSelectionToolController)
 
    // Core components
    QPointer<QWidget> m_parentWidget;
    cvViewSelectionManager* m_manager;
    bool m_selectionToolsActive;
    QPointer<QObject> m_propertiesDelegate;
 
    // Reactions for each selection mode
    QMap<SelectionMode, QPointer<cvRenderViewSelectionReaction>> m_reactions;
 
    // Store actions for ESC handling
    SelectionActions m_actions;
 
    // Modifier action group
    QPointer<QActionGroup> m_modifierGroup;
    QPointer<QAction> m_addAction;
    QPointer<QAction> m_subtractAction;
    QPointer<QAction> m_toggleAction;
 
    // Manipulation actions
    QPointer<QAction> m_growAction;
    QPointer<QAction> m_shrinkAction;
    QPointer<QAction> m_clearAction;
};