cvSelectionData.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
 
// LOCAL
#include "qPCL.h"
 
// QT
#include <QtCore/QHashFunctions>
#include <QtCore/QSharedPointer>
#include <QtCore/QString>
#include <QtCore/QVector>
 
// VTK
#include <vtkSmartPointer.h>
 
// Forward declarations (VTK types - not exposed in public API)
class vtkIdTypeArray;
class vtkPolyData;
class vtkActor;
 
//=============================================================================
// Selection Types and Enums (merged from cvSelectionTypes.h)
//=============================================================================
 
enum class SelectionMode {
    // Surface selection
    SELECT_SURFACE_CELLS,           
    SELECT_SURFACE_POINTS,          
    SELECT_SURFACE_CELLS_POLYGON,   
    SELECT_SURFACE_POINTS_POLYGON,  
 
    // Frustum selection
    SELECT_FRUSTUM_CELLS,   
    SELECT_FRUSTUM_POINTS,  
 
    // Block selection
    SELECT_BLOCKS,          
    SELECT_FRUSTUM_BLOCKS,  
 
    // Interactive selection
    SELECT_SURFACE_CELLS_INTERACTIVELY,      
    SELECT_SURFACE_POINTS_INTERACTIVELY,     
    SELECT_SURFACE_CELLDATA_INTERACTIVELY,   
    SELECT_SURFACE_POINTDATA_INTERACTIVELY,  
 
    // Tooltip selection (Hovering mode)
    HOVER_CELLS_TOOLTIP,   
    HOVER_POINTS_TOOLTIP,  
 
    // Custom selection (emit signals with selection region)
    SELECT_CUSTOM_POLYGON,  
 
    // Zoom mode (ParaView-aligned)
    ZOOM_TO_BOX,  
 
    // Selection management
    CLEAR_SELECTION,  
    GROW_SELECTION,   
    SHRINK_SELECTION  
};
 
enum class SelectionModifier {
    SELECTION_DEFAULT,      
    SELECTION_ADDITION,     
    SELECTION_SUBTRACTION,  
    SELECTION_TOGGLE        
};
 
// Provide qHash function for SelectionMode to support QSet<SelectionMode>
inline uint qHash(SelectionMode key, uint seed = 0) noexcept {
    return qHash(static_cast<int>(key), seed);
}
 
// Provide qHash function for SelectionModifier to support
// QSet<SelectionModifier>
inline uint qHash(SelectionModifier key, uint seed = 0) noexcept {
    return qHash(static_cast<int>(key), seed);
}
 
//=============================================================================
// Selection Data Classes
//=============================================================================
 
struct QPCL_ENGINE_LIB_API cvActorSelectionInfo {
    vtkActor* actor;        
    vtkPolyData* polyData;  
    double zValue;  
    int propId;     
    unsigned int blockIndex;  
    QString actorName;        
 
    cvActorSelectionInfo()
        : actor(nullptr),
          polyData(nullptr),
          zValue(1.0),
          propId(-1),
          blockIndex(0),
          actorName("") {}
};
 
class QPCL_ENGINE_LIB_API cvSelectionData {
public:
    enum FieldAssociation {
        CELLS = 0,  
        POINTS = 1  
    };
 
    cvSelectionData();
 
    cvSelectionData(vtkIdTypeArray* vtkArray, int association);
 
    cvSelectionData(const QVector<qint64>& ids, FieldAssociation association);
 
    cvSelectionData(const cvSelectionData& other);
 
    cvSelectionData& operator=(const cvSelectionData& other);
 
    ~cvSelectionData();
 
    bool isEmpty() const;
 
    int count() const;
 
    FieldAssociation fieldAssociation() const { return m_fieldAssociation; }
 
    QVector<qint64> ids() const;
 
    vtkSmartPointer<vtkIdTypeArray> vtkArray() const { return m_vtkArray; }
 
    void clear();
 
    QString fieldTypeString() const;
 
 
    void addActorInfo(const cvActorSelectionInfo& info);
 
    void setActorInfo(vtkActor* actor,
                      vtkPolyData* polyData,
                      double zValue = 1.0);
 
    int actorCount() const { return m_actorInfos.size(); }
 
    bool hasActorInfo() const { return !m_actorInfos.isEmpty(); }
 
    cvActorSelectionInfo actorInfo(int index = 0) const;
 
    QVector<cvActorSelectionInfo> actorInfos() const { return m_actorInfos; }
 
    vtkActor* primaryActor() const;
 
    vtkPolyData* primaryPolyData() const;
 
    void clearActorInfo();
 
 
private:
    vtkSmartPointer<vtkIdTypeArray>
            m_vtkArray;  
    FieldAssociation m_fieldAssociation;  
 
    QVector<cvActorSelectionInfo> m_actorInfos;
};
 
using cvSelectionDataPtr = QSharedPointer<cvSelectionData>;