Lightweight base class for all selection-related components. More...

#include <cvSelectionBase.h>

Inheritance diagram for cvSelectionBase:

[legend]

Collaboration diagram for cvSelectionBase:

[legend]

Public Member Functions
	cvSelectionBase ()

virtual	~cvSelectionBase ()=default

virtual void	setVisualizer (ecvGenericVisualizer3D *viewer)
	Set the visualizer instance. More...

ecvGenericVisualizer3D *	getVisualizer () const
	Get the visualizer instance. More...

Protected Member Functions
PclUtils::PCLVis *	getPCLVis () const
	Get PCLVis instance (for VTK-specific operations) More...

bool	hasValidPCLVis () const
	Check if visualizer is valid and is PCLVis. More...

vtkDataSet *	getDataFromActor (vtkActor *actor)
	Get data object from a specific actor (ParaView-style) More...

QList< vtkActor * >	getDataActors () const
	Get all visible data actors from visualizer. More...

std::vector< vtkPolyData * >	getAllPolyDataFromVisualizer ()
	Get all polyData from the visualizer. More...

virtual vtkPolyData *	getPolyDataForSelection (const cvSelectionData *selectionData=nullptr)
	Get polyData using ParaView-style priority (centralized method) More...

Protected Attributes
ecvGenericVisualizer3D *	m_viewer
	Visualizer instance (abstract interface) More...

Detailed Description

Lightweight base class for all selection-related components.

Provides only visualizer access without adding unnecessary functionality. This base class is designed to be minimal (~16 bytes) to avoid memory overhead for components that only need visualizer access.

Usage guidelines:

Use cvSelectionBase when you only need visualizer access (e.g., cvSelectionHighlighter, cvSelectionPropertiesWidget)
Use cvGenericSelectionTool when you need picking/selection functionality (e.g., cvSurfaceSelectionTool, cvTooltipSelectionTool)

Design rationale:

Follows Interface Segregation Principle (ISP)
Avoids forcing clients to depend on methods they don't use
Reduces memory footprint for non-picking components by ~60-70%

Definition at line 44 of file cvSelectionBase.h.

Constructor & Destructor Documentation

◆ cvSelectionBase()

cvSelectionBase::cvSelectionBase ( )

inline

Definition at line 46 of file cvSelectionBase.h.

◆ ~cvSelectionBase()

virtual cvSelectionBase::~cvSelectionBase ( )

virtualdefault

Member Function Documentation

◆ getAllPolyDataFromVisualizer()

std::vector< vtkPolyData * > cvSelectionBase::getAllPolyDataFromVisualizer ( )

protected

Get all polyData from the visualizer.

Returns: Vector of all valid vtkPolyData pointers (may be empty)

Returns all valid polyData from visible and pickable actors in the renderer. Useful when you need to process multiple actors or when the default selection strategy (largest actor) is not appropriate.

Definition at line 154 of file cvSelectionBase.cpp.

References PclUtils::PCLVis::getCurrentRenderer(), getPCLVis(), CVLog::PrintVerbose(), and CVLog::Warning().

◆ getDataActors()

QList< vtkActor * > cvSelectionBase::getDataActors ( ) const

protected

Get all visible data actors from visualizer.

Returns: List of pickable actors with data

Definition at line 117 of file cvSelectionBase.cpp.

References PclUtils::PCLVis::getCurrentRenderer(), getPCLVis(), CVLog::PrintVerbose(), and CVLog::Warning().

Referenced by cvViewSelectionManager::getPolyData(), and getPolyDataForSelection().

◆ getDataFromActor()

vtkDataSet * cvSelectionBase::getDataFromActor ( vtkActor * actor )

protected

Get data object from a specific actor (ParaView-style)

Parameters

actor The target actor

Returns: Data object from actor's mapper, or nullptr

Definition at line 49 of file cvSelectionBase.cpp.

References data, and CVLog::PrintVerbose().

Referenced by cvViewSelectionManager::getPolyData(), and getPolyDataForSelection().

◆ getPCLVis()

PclUtils::PCLVis * cvSelectionBase::getPCLVis ( ) const

protected

Get PCLVis instance (for VTK-specific operations)

Returns: Pointer to PCLVis, or nullptr if cast fails

Use this method when you need to access VTK-specific functionality like getCurrentRenderer(), UpdateScreen(), etc.

Always check for nullptr before using!

Definition at line 33 of file cvSelectionBase.cpp.

References m_viewer.

Referenced by cvSelectionHighlighter::clearHighlights(), getAllPolyDataFromVisualizer(), getDataActors(), hasValidPCLVis(), cvSelectionHighlighter::setHighlightColor(), cvSelectionPropertiesWidget::setHighlighter(), cvSelectionHighlighter::setHighlightOpacity(), cvSelectionHighlighter::setHighlightsVisible(), and cvViewSelectionManager::setVisualizer().

◆ getPolyDataForSelection()

vtkPolyData * cvSelectionBase::getPolyDataForSelection ( const cvSelectionData * selectionData = nullptr )

protectedvirtual

Get polyData using ParaView-style priority (centralized method)

Parameters

selectionData Optional selection data to extract from (highest priority)

Returns: PolyData pointer, or nullptr if not available

This method encapsulates the ParaView-style priority logic: Priority 1: From selectionData's actor info (if provided and has actor info) Priority 2: From selection manager singleton's getPolyData() Priority 3: From first data actor (fallback for non-selection operations)

This centralizes the logic and avoids duplication across all tools. Uses cvViewSelectionManager::instance() internally (singleton pattern).

Note: Subclasses (like cvGenericSelectionTool) can provide enhanced versions that also check their m_currentSelection.

Reimplemented in cvGenericSelectionTool.

Definition at line 72 of file cvSelectionBase.cpp.

References data, getDataActors(), getDataFromActor(), cvViewSelectionManager::getPolyData(), cvSelectionData::hasActorInfo(), cvViewSelectionManager::instance(), cvSelectionData::primaryPolyData(), and CVLog::PrintVerbose().

Referenced by cvGenericSelectionTool::getPolyDataForSelection(), and cvSelectionPropertiesWidget::updateSelection().