QGraphicsScale Class
The QGraphicsScale class provides a scale transformation. More...
| Header: | #include <QGraphicsScale> |
| qmake: | QT += widgets |
| Since: | Qt 4.6 |
| Inherits: | QGraphicsTransform |
Properties
- 1 property inherited from QObject
Public Functions
| QGraphicsScale(QObject *parent = Q_NULLPTR) | |
| ~QGraphicsScale() | |
| QVector3D | origin() const |
| void | setOrigin(const QVector3D &point) |
| void | setXScale(qreal) |
| void | setYScale(qreal) |
| void | setZScale(qreal) |
| qreal | xScale() const |
| qreal | yScale() const |
| qreal | zScale() const |
Reimplemented Public Functions
| virtual void | applyTo(QMatrix4x4 *matrix) const |
- 1 public function inherited from QGraphicsTransform
- 31 public functions inherited from QObject
Signals
| void | originChanged() |
| void | scaleChanged() |
| void | xScaleChanged() |
| void | yScaleChanged() |
| void | zScaleChanged() |
- 2 signals inherited from QObject
Additional Inherited Members
- 1 public slot inherited from QObject
- 1 public variable inherited from QObject
- 10 static public members inherited from QObject
- 9 protected functions inherited from QObject
- 1 protected slot inherited from QGraphicsTransform
- 2 protected variables inherited from QObject
Detailed Description
The QGraphicsScale class provides a scale transformation.
QGraphicsScene provides certain parameters to help control how the scale should be applied.
The origin is the point that the item is scaled from (i.e., it stays fixed relative to the parent as the rest of the item grows). By default the origin is QPointF(0, 0).
The parameters xScale, yScale, and zScale describe the scale factors to apply in horizontal, vertical, and depth directions. They can take on any value, including 0 (to collapse the item to a point) or negative value. A negative xScale value will mirror the item horizontally. A negative yScale value will flip the item vertically. A negative zScale will flip the item end for end.
See also QGraphicsTransform, QGraphicsItem::setScale(), and QTransform::scale().
Property Documentation
origin : QVector3D
This property holds the origin of the scale in 3D space.
All scaling will be done relative to this point (i.e., this point will stay fixed, relative to the parent, when the item is scaled).
Access functions:
| QVector3D | origin() const |
| void | setOrigin(const QVector3D &point) |
Notifier signal:
| void | originChanged() |
See also xScale, yScale, and zScale.
xScale : qreal
This property holds the horizontal scale factor.
The scale factor can be any real number; the default value is 1.0. If you set the factor to 0.0, the item will be collapsed to a single point. If you provide a negative value, the item will be mirrored horizontally around its origin.
Access functions:
| qreal | xScale() const |
| void | setXScale(qreal) |
Notifier signal:
| void | xScaleChanged() |
See also yScale, zScale, and origin.
yScale : qreal
This property holds the vertical scale factor.
The scale factor can be any real number; the default value is 1.0. If you set the factor to 0.0, the item will be collapsed to a single point. If you provide a negative value, the item will be flipped vertically around its origin.
Access functions:
| qreal | yScale() const |
| void | setYScale(qreal) |
Notifier signal:
| void | yScaleChanged() |
See also xScale, zScale, and origin.
zScale : qreal
This property holds the depth scale factor.
The scale factor can be any real number; the default value is 1.0. If you set the factor to 0.0, the item will be collapsed to a single point. If you provide a negative value, the item will be flipped end for end around its origin.
Access functions:
| qreal | zScale() const |
| void | setZScale(qreal) |
Notifier signal:
| void | zScaleChanged() |
Member Function Documentation
QGraphicsScale::QGraphicsScale(QObject *parent = Q_NULLPTR)
Constructs an empty QGraphicsScale object with the given parent.
QGraphicsScale::~QGraphicsScale()
Destroys the graphics scale.
[virtual] void QGraphicsScale::applyTo(QMatrix4x4 *matrix) const
Reimplemented from QGraphicsTransform::applyTo().
[signal] void QGraphicsScale::originChanged()
QGraphicsScale emits this signal when its origin changes.
Note: Notifier signal for property origin.
See also QGraphicsScale::origin.
[signal] void QGraphicsScale::scaleChanged()
This signal is emitted whenever the xScale, yScale, or zScale of the object changes.
See also QGraphicsScale::xScale, QGraphicsScale::yScale, and QGraphicsScale::zScale.
[signal] void QGraphicsScale::xScaleChanged()
This signal is emitted whenever the xScale property changes.
This function was introduced in Qt 4.7.
Note: Notifier signal for property xScale.
[signal] void QGraphicsScale::yScaleChanged()
This signal is emitted whenever the yScale property changes.
This function was introduced in Qt 4.7.
Note: Notifier signal for property yScale.
[signal] void QGraphicsScale::zScaleChanged()
This signal is emitted whenever the zScale property changes.
This function was introduced in Qt 4.7.
Note: Notifier signal for property zScale.