Medical Imaging Interaction Toolkit  2026.06.00
Medical Imaging Interaction Toolkit
QmitkMapperSettingsWidget Class Reference

Widget for configuring image mapping / geometry refinement settings. More...

#include <QmitkMapperSettingsWidget.h>

Inheritance diagram for QmitkMapperSettingsWidget:
Collaboration diagram for QmitkMapperSettingsWidget:

Public Slots

void SetMaskMode (bool activeMask)
 Enables or disables mask mode. More...
 
void AllowSampling (bool allow)
 Enables or disables the super/sub-sampling controls. More...
 

Public Member Functions

 QmitkMapperSettingsWidget (QWidget *parent=nullptr)
 Constructs the mapper settings widget. More...
 
 ~QmitkMapperSettingsWidget () override
 Destructor. More...
 
void ConfigureJobSettings (QmitkMappingJobSettings *settings)
 Populates a QmitkMappingJobSettings instance from the current widget state. More...
 

Protected Slots

void OnLinkSampleFactorChecked ()
 
void OnXFactorChanged (double d)
 

Protected Attributes

std::unique_ptr< Ui::QmitkMapperSettingsWidget > m_Controls
 
bool m_MaskMode
 
bool m_allowSampling
 

Detailed Description

Widget for configuring image mapping / geometry refinement settings.

This widget allows the user to configure how images are mapped using a registration, including interpolation method, handling of undefined and unregistered pixels, padding/error values, and optional super/sub-sampling factors (with linked or independent axis control).

The widget supports a "mask mode" that restricts interpolation to nearest-neighbour only, which is required when mapping segmentation masks to preserve label integrity.

Use ConfigureJobSettings() to transfer the current widget state into a QmitkMappingJobSettings instance before starting a mapping job.

See also
QmitkMappingJobSettings, QmitkMappingJob, QmitkFramesRegistrationJob

Definition at line 45 of file QmitkMapperSettingsWidget.h.

Constructor & Destructor Documentation

◆ QmitkMapperSettingsWidget()

QmitkMapperSettingsWidget::QmitkMapperSettingsWidget ( QWidget *  parent = nullptr)

Constructs the mapper settings widget.

Parameters
[in]parentOptional parent widget.

◆ ~QmitkMapperSettingsWidget()

QmitkMapperSettingsWidget::~QmitkMapperSettingsWidget ( )
override

Destructor.

Member Function Documentation

◆ AllowSampling

void QmitkMapperSettingsWidget::AllowSampling ( bool  allow)
slot

Enables or disables the super/sub-sampling controls.

When disabled, the sampling factor group is hidden from the UI.

Parameters
[in]allowIf true, sampling controls are shown and available; if false, they are hidden.

◆ ConfigureJobSettings()

void QmitkMapperSettingsWidget::ConfigureJobSettings ( QmitkMappingJobSettings *  settings)

Populates a QmitkMappingJobSettings instance from the current widget state.

Copies the interpolation type, undefined/unregistered pixel handling, padding value, and error value from the UI controls into the provided settings object.

Parameters
[in,out]settingsPointer to the settings instance to configure.
Precondition
settings must not be nullptr.

◆ OnLinkSampleFactorChecked

void QmitkMapperSettingsWidget::OnLinkSampleFactorChecked ( )
protectedslot

◆ OnXFactorChanged

void QmitkMapperSettingsWidget::OnXFactorChanged ( double  d)
protectedslot

◆ SetMaskMode

void QmitkMapperSettingsWidget::SetMaskMode ( bool  activeMask)
slot

Enables or disables mask mode.

In mask mode, the interpolation method is forced to nearest-neighbour and error/padding values are set to 0. This is required when mapping segmentation masks to avoid interpolation artifacts.

Parameters
[in]activeMaskIf true, activates mask mode; if false, deactivates it and resets interpolation to linear.

Member Data Documentation

◆ m_allowSampling

bool QmitkMapperSettingsWidget::m_allowSampling
protected

Definition at line 101 of file QmitkMapperSettingsWidget.h.

◆ m_Controls

std::unique_ptr<Ui::QmitkMapperSettingsWidget> QmitkMapperSettingsWidget::m_Controls
protected

Definition at line 99 of file QmitkMapperSettingsWidget.h.

◆ m_MaskMode

bool QmitkMapperSettingsWidget::m_MaskMode
protected

Definition at line 100 of file QmitkMapperSettingsWidget.h.


The documentation for this class was generated from the following file: