C

Q3DSDataOutput Class

Provides notifications from data output entries in Qt 3D Studio presentation. More...

Header: #include <Q3DSDataOutput>
Since: Qt 3D Studio 2.4
Instantiated By: DataOutput
Inherits: QObject

This class was introduced in Qt 3D Studio 2.4.

Properties

Public Functions

QString name() const
QVariant value() const

Public Slots

void setName(const QString &name)

Signals

void nameChanged(const QString &newName)
void valueChanged(const QVariant &newValue)

Detailed Description

This class is a convenience class for listening for changes in the Qt 3D Studio presentation attributes. DataOutput provides a clean contract between the presentation design and the code. It hides the presentation details from the code while providing a contractual access point to code to be notified when aspects of the presentation change (e.g. movement of an element in the presentation due to timeline animation).

DataOutput can be attached to same attributes in the design as DataInput is, including presentation timeline. Only exception is slide changes (slide changes are already notified through Q3DSPresentation::slideEntered and Q3DSPresentation::slideExited signals).

Note: There is a performance cost for each registered DataOutput, so try to avoid creating unnecessary DataOutputs.

For other integration points between code and presentation see:

See also Q3DSPresentation::customSignalEmitted, Q3DSPresentation::slideEntered, Q3DSPresentation::slideExited, Q3DSDataInput, and Q3DSPresentation.

Property Documentation

name : QString

Specifies the name of the observed data output element in the presentation. The name must match a name of a data output defined in the presentation.

This property must be set before setting the value property. The initial value is provided via the constructor, but the name can also be changed later on.

Access functions:

QString name() const
void setName(const QString &name)

Notifier signal:

void nameChanged(const QString &newName)

value : const QVariant

Contains the read-only value of the controlled data output element in the presentation.

The value of this property accounts for actual value in the last processed frame of the presentation. This includes animation timeline driven changes, changes done via DataInput and changes done via Behavior scripts.

Access functions:

QVariant value() const

Notifier signal:

void valueChanged(const QVariant &newValue)

Member Function Documentation

[signal] void Q3DSDataOutput::valueChanged(const QVariant &newValue)

Emitted when the value of the observed DataOutput has changed to newValue in the presentation.

Note: Notifier signal for property value.

Available under certain Qt licenses.
Find out more.