- Qt 6.7
- Qt Graphs
- C++ Classes
- QtGraphs (Technical Preview)
- QAbstract3DInputHandler
- Qt Graphs | Commercial or GPLv3

# QAbstract3DInputHandler Class

The base class for implementations of 3D input handlers. More...

Header: | #include <QAbstract3DInputHandler>
CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: | QT += graphs
Instantiated By: | AbstractInputHandler3D
Inherits: | QObject
Inherited By: | Q3DInputHandler
Status: | Technical Preview

- List of all members, including inherited members
- QAbstract3DInputHandler is part of Qt Graphs C++ Classes for 3D.

## Public Types

enum class | InputView { None, OnPrimary, OnSecondary }

## Properties

- inputPosition : QPoint
- inputView : QAbstract3DInputHandler::InputView
- scene : Q3DScene*

## Public Functions

virtual | ~QAbstract3DInputHandler()
QPoint | inputPosition() const
QAbstract3DInputHandler::InputView | inputView() const
virtual void | mouseDoubleClickEvent(QMouseEvent *event)
virtual void | mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos)
virtual void | mousePressEvent(QMouseEvent *event, const QPoint &mousePos)
virtual void | mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos)
Q3DScene * | scene() const
void | setInputPosition(const QPoint &position, bool forceSelection = false)
void | setInputView(QAbstract3DInputHandler::InputView inputView)
void | setScene(Q3DScene *scene)
virtual void | touchEvent(QTouchEvent *event)
virtual void | wheelEvent(QWheelEvent *event)

## Public Slots

void | handleSelection(const QPoint &position)

## Signals

void | inputViewChanged(QAbstract3DInputHandler::InputView view)
void | positionChanged(const QPoint &position)
void | sceneChanged(Q3DScene *scene)

## Protected Functions

| QAbstract3DInputHandler(QObject *parent = nullptr)
int | prevDistance() const
QPoint | previousInputPos() const
void | setPrevDistance(int distance)
void | setPreviousInputPos(const QPoint &position)

## Detailed Description

QAbstract3DInputHandler is the base class that is subclassed by different input handling implementations that take input events and translate those to camera and light movements. Input handlers also translate raw input events to slicing and selection events in the scene.

## Member Type Documentation

### enum class QAbstract3DInputHandler::InputView

Predefined input views for mouse and touch based input handlers.

Constant | Value | Description
--- | --- | ---
`QAbstract3DInputHandler::InputView::None` | `0` | Mouse or touch not on a view.
`QAbstract3DInputHandler::InputView::OnPrimary` | `1` | Mouse or touch input received on the primary view area. If secondary view is displayed when inputView becomes OnPrimary, secondary view is closed.
`QAbstract3DInputHandler::InputView::OnSecondary` | `2` | Mouse or touch input received on the secondary view area.

## Property Documentation

### inputPosition : QPoint

This property holds the last input position based on the processed input events.

Access functions:

QPoint | inputPosition() const
void | setInputPosition(const QPoint &position, bool forceSelection = false)

Notifier signal:

void | positionChanged(const QPoint &position)

### inputView : QAbstract3DInputHandler::InputView

This property holds the current enumerated input view based on the view of the processed input events.

One of the InputView enum values.

When the view changes, the `inputViewChanged` signal is emitted.

Access functions:

QAbstract3DInputHandler::InputView | inputView() const
void | setInputView(QAbstract3DInputHandler::InputView inputView)

Notifier signal:

void | inputViewChanged(QAbstract3DInputHandler::InputView view)

See also InputView.

### scene : Q3DScene*

This property holds the 3D scene this abstract input handler is controlling.

One input handler can control one scene. Setting a scene to an input handler does not transfer the ownership of the scene.

Access functions:

Q3DScene * | scene() const
void | setScene(Q3DScene *scene)

Notifier signal:

void | sceneChanged(Q3DScene *scene)

## Member Function Documentation

### `[explicit protected]` QAbstract3DInputHandler::QAbstract3DInputHandler(QObject *parent = nullptr)

Constructs the base class. An optional parent parameter can be given and is then passed to QObject constructor.

### `[virtual noexcept]` QAbstract3DInputHandler::~QAbstract3DInputHandler()

Destroys the base class.

### `[slot]` void QAbstract3DInputHandler::handleSelection(const QPoint &position)

Converts an incoming selection query position to a selection.

See also Q3DScene::selectionQueryPosition.

### `[virtual]` void QAbstract3DInputHandler::mouseDoubleClickEvent(QMouseEvent *event)

Override this to handle mouse double click events. Mouse double click event is given in the event.

### `[virtual]` void QAbstract3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos)

Override this to handle mouse move events. Mouse move event is given in the event and the mouse position in mousePos.

### `[virtual]` void QAbstract3DInputHandler::mousePressEvent(QMouseEvent *event, const QPoint &mousePos)

Override this to handle mouse press events. Mouse press event is given in the event and the mouse position in mousePos.

### `[virtual]` void QAbstract3DInputHandler::mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos)

Override this to handle mouse release events. Mouse release event is given in the event and the mouse position in mousePos.

### `[protected]` int QAbstract3DInputHandler::prevDistance() const

Returns the manhattan length between last two input positions.

See also setPrevDistance().

### `[protected]` QPoint QAbstract3DInputHandler::previousInputPos() const

Returns the previous input position.

See also setPreviousInputPos().

### `[protected]` void QAbstract3DInputHandler::setPrevDistance(int distance)

Sets the distance (manhattan length) between last two input positions.

See also prevDistance().

### `[protected]` void QAbstract3DInputHandler::setPreviousInputPos(const QPoint &position)

Sets the previous input position to the point given by position.

See also previousInputPos().

### `[virtual]` void QAbstract3DInputHandler::touchEvent(QTouchEvent *event)

Override this to handle touch input events. Touch event is given in the event.

### `[virtual]` void QAbstract3DInputHandler::wheelEvent(QWheelEvent *event)

Override this to handle wheel events. Wheel event is given in the event.