<?xml version="1.0" encoding="iso-8859-1"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <!-- qgraphicstransform.cpp --> <head> <title>Qt 4.6: QGraphicsScale Class Reference</title> <link href="classic.css" rel="stylesheet" type="text/css" /> </head> <body> <a name="//apple_ref/cpp/cl//QGraphicsScale"></a> <table border="0" cellpadding="0" cellspacing="0" width="100%"> <tr> <td align="left" valign="top" width="32"><a href="http://qt.nokia.com/"><img src="images/qt-logo.png" align="left" border="0" /></a></td> <td width="1"> </td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a> · <a href="classes.html"><font color="#004faf">All Classes</font></a> · <a href="functions.html"><font color="#004faf">All Functions</font></a> · <a href="overviews.html"><font color="#004faf">Overviews</font></a></td></tr></table><h1 class="title">QGraphicsScale Class Reference<br /><span class="small-subtitle">[<a href="qtgui.html">QtGui</a> module]</span> </h1> <p>The QGraphicsScale class provides a scale transformation. <a href="#details">More...</a></p> <pre> #include <QGraphicsScale></pre><p>Inherits <a href="qgraphicstransform.html">QGraphicsTransform</a>.</p> <p>This class was introduced in Qt 4.6.</p> <ul> <li><a href="qgraphicsscale-members.html">List of all members, including inherited members</a></li> </ul> <hr /> <a name="properties"></a> <h2>Properties</h2> <ul> <li><div class="fn"><b><a href="qgraphicsscale.html#origin-prop">origin</a></b> : QVector3D</div></li> <li><div class="fn"><b><a href="qgraphicsscale.html#xScale-prop">xScale</a></b> : qreal</div></li> <li><div class="fn"><b><a href="qgraphicsscale.html#yScale-prop">yScale</a></b> : qreal</div></li> <li><div class="fn"><b><a href="qgraphicsscale.html#zScale-prop">zScale</a></b> : qreal</div></li> </ul> <ul> <li><div bar="2" class="fn"></div>1 property inherited from <a href="qobject.html#properties">QObject</a></li> </ul> <hr /> <a name="public-functions"></a> <h2>Public Functions</h2> <table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> <tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qgraphicsscale.html#QGraphicsScale">QGraphicsScale</a></b> ( QObject * <i>parent</i> = 0 )</td></tr> <tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qgraphicsscale.html#dtor.QGraphicsScale">~QGraphicsScale</a></b> ()</td></tr> <tr><td class="memItemLeft" align="right" valign="top">QVector3D </td><td class="memItemRight" valign="bottom"><b><a href="qgraphicsscale.html#origin-prop">origin</a></b> () const</td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qgraphicsscale.html#origin-prop">setOrigin</a></b> ( const QVector3D & <i>point</i> )</td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qgraphicsscale.html#xScale-prop">setXScale</a></b> ( qreal )</td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qgraphicsscale.html#yScale-prop">setYScale</a></b> ( qreal )</td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qgraphicsscale.html#zScale-prop">setZScale</a></b> ( qreal )</td></tr> <tr><td class="memItemLeft" align="right" valign="top">qreal </td><td class="memItemRight" valign="bottom"><b><a href="qgraphicsscale.html#xScale-prop">xScale</a></b> () const</td></tr> <tr><td class="memItemLeft" align="right" valign="top">qreal </td><td class="memItemRight" valign="bottom"><b><a href="qgraphicsscale.html#yScale-prop">yScale</a></b> () const</td></tr> <tr><td class="memItemLeft" align="right" valign="top">qreal </td><td class="memItemRight" valign="bottom"><b><a href="qgraphicsscale.html#zScale-prop">zScale</a></b> () const</td></tr> </table> <hr /> <a name="reimplemented-public-functions"></a> <h2>Reimplemented Public Functions</h2> <table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> <tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><b><a href="qgraphicsscale.html#applyTo">applyTo</a></b> ( QMatrix4x4 * <i>matrix</i> ) const</td></tr> </table> <ul> <li><div bar="2" class="fn"></div>1 public function inherited from <a href="qgraphicstransform.html#public-functions">QGraphicsTransform</a></li> <li><div bar="2" class="fn"></div>29 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li> </ul> <hr /> <a name="signals"></a> <h2>Signals</h2> <table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qgraphicsscale.html#originChanged">originChanged</a></b> ()</td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qgraphicsscale.html#scaleChanged">scaleChanged</a></b> ()</td></tr> </table> <ul> <li><div bar="2" class="fn"></div>1 signal inherited from <a href="qobject.html#signals">QObject</a></li> </ul> <h3>Additional Inherited Members</h3> <ul> <li><div class="fn"></div>1 public slot inherited from <a href="qobject.html#public-slots">QObject</a></li> <li><div class="fn"></div>5 static public members inherited from <a href="qobject.html#static-public-members">QObject</a></li> <li><div class="fn"></div>7 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li> <li><div class="fn"></div>1 protected slot inherited from <a href="qgraphicstransform.html#protected-slots">QGraphicsTransform</a></li> </ul> <a name="details"></a> <hr /> <h2>Detailed Description</h2> <p>The QGraphicsScale class provides a scale transformation.</p> <p><a href="qgraphicsscene.html">QGraphicsScene</a> provides certain parameters to help control how the scale should be applied.</p> <p>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 <a href="qpointf.html">QPointF</a>(0, 0).</p> <p>The parameters <a href="qgraphicsscale.html#xScale-prop">xScale</a>, <a href="qgraphicsscale.html#yScale-prop">yScale</a>, and <a href="qgraphicsscale.html#zScale-prop">zScale</a> 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 <a href="qgraphicsscale.html#xScale-prop">xScale</a> value will mirror the item horizontally. A negative <a href="qgraphicsscale.html#yScale-prop">yScale</a> value will flip the item vertically. A negative <a href="qgraphicsscale.html#zScale-prop">zScale</a> will flip the item end for end.</p> <p>See also <a href="qgraphicstransform.html">QGraphicsTransform</a>, <a href="qgraphicsitem.html#setScale">QGraphicsItem::setScale</a>(), and <a href="qtransform.html#scale">QTransform::scale</a>().</p> <hr /> <h2>Property Documentation</h2> <a name="//apple_ref/cpp/instm/QGraphicsScale/origin"></a> <a name="//apple_ref/cpp/instm/QGraphicsScale/setOrigin"></a> <a name="//apple_ref/cpp/instm/QGraphicsScale/originChanged"></a> <h3 class="fn"><a name="origin-prop"></a>origin : <a href="qvector3d.html">QVector3D</a></h3> <p>This property holds the origin of the scale in 3D space.</p> <p>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).</p> <p><b>Access functions:</b></p> <table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> <tr><td class="memItemLeft" align="right" valign="top">QVector3D </td><td class="memItemRight" valign="bottom"><b>origin</b> () const</td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b>setOrigin</b> ( const QVector3D & <i>point</i> )</td></tr> </table> <p><b>Notifier signal:</b></p> <table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qgraphicsscale.html#originChanged">originChanged</a></b> ()</td></tr> </table> <p>See also <a href="qgraphicsscale.html#xScale-prop">xScale</a>, <a href="qgraphicsscale.html#yScale-prop">yScale</a>, and <a href="qgraphicsscale.html#zScale-prop">zScale</a>.</p> <a name="//apple_ref/cpp/instm/QGraphicsScale/xScale"></a> <a name="//apple_ref/cpp/instm/QGraphicsScale/setXScale"></a> <a name="//apple_ref/cpp/instm/QGraphicsScale/scaleChanged"></a> <h3 class="fn"><a name="xScale-prop"></a>xScale : <a href="qtglobal.html#qreal-typedef">qreal</a></h3> <p>This property holds the horizontal scale factor.</p> <p>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.</p> <p><b>Access functions:</b></p> <table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> <tr><td class="memItemLeft" align="right" valign="top">qreal </td><td class="memItemRight" valign="bottom"><b>xScale</b> () const</td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b>setXScale</b> ( qreal )</td></tr> </table> <p><b>Notifier signal:</b></p> <table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qgraphicsscale.html#scaleChanged">scaleChanged</a></b> ()</td></tr> </table> <p>See also <a href="qgraphicsscale.html#yScale-prop">yScale</a>, <a href="qgraphicsscale.html#zScale-prop">zScale</a>, and <a href="qgraphicsscale.html#origin-prop">origin</a>.</p> <a name="//apple_ref/cpp/instm/QGraphicsScale/yScale"></a> <a name="//apple_ref/cpp/instm/QGraphicsScale/setYScale"></a> <a name="//apple_ref/cpp/instm/QGraphicsScale/scaleChanged"></a> <h3 class="fn"><a name="yScale-prop"></a>yScale : <a href="qtglobal.html#qreal-typedef">qreal</a></h3> <p>This property holds the vertical scale factor.</p> <p>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.</p> <p><b>Access functions:</b></p> <table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> <tr><td class="memItemLeft" align="right" valign="top">qreal </td><td class="memItemRight" valign="bottom"><b>yScale</b> () const</td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b>setYScale</b> ( qreal )</td></tr> </table> <p><b>Notifier signal:</b></p> <table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qgraphicsscale.html#scaleChanged">scaleChanged</a></b> ()</td></tr> </table> <p>See also <a href="qgraphicsscale.html#xScale-prop">xScale</a>, <a href="qgraphicsscale.html#zScale-prop">zScale</a>, and <a href="qgraphicsscale.html#origin-prop">origin</a>.</p> <a name="//apple_ref/cpp/instm/QGraphicsScale/zScale"></a> <a name="//apple_ref/cpp/instm/QGraphicsScale/setZScale"></a> <a name="//apple_ref/cpp/instm/QGraphicsScale/scaleChanged"></a> <h3 class="fn"><a name="zScale-prop"></a>zScale : <a href="qtglobal.html#qreal-typedef">qreal</a></h3> <p>This property holds the depth scale factor.</p> <p>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.</p> <p><b>Access functions:</b></p> <table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> <tr><td class="memItemLeft" align="right" valign="top">qreal </td><td class="memItemRight" valign="bottom"><b>zScale</b> () const</td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b>setZScale</b> ( qreal )</td></tr> </table> <p><b>Notifier signal:</b></p> <table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%"> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qgraphicsscale.html#scaleChanged">scaleChanged</a></b> ()</td></tr> </table> <p>See also <a href="qgraphicsscale.html#xScale-prop">xScale</a>, <a href="qgraphicsscale.html#yScale-prop">yScale</a>, and <a href="qgraphicsscale.html#origin-prop">origin</a>.</p> <hr /> <h2>Member Function Documentation</h2> <a name="//apple_ref/cpp/instm/QGraphicsScale/QGraphicsScale"></a> <h3 class="fn"><a name="QGraphicsScale"></a>QGraphicsScale::QGraphicsScale ( <a href="qobject.html">QObject</a> * <i>parent</i> = 0 )</h3> <p>Constructs an empty <a href="qgraphicsscale.html">QGraphicsScale</a> object with the given <i>parent</i>.</p> <a name="//apple_ref/cpp/instm/QGraphicsScale/~QGraphicsScale"></a> <h3 class="fn"><a name="dtor.QGraphicsScale"></a>QGraphicsScale::~QGraphicsScale ()</h3> <p>Destroys the graphics scale.</p> <a name="//apple_ref/cpp/instm/QGraphicsScale/applyTo"></a> <h3 class="fn"><a name="applyTo"></a>void QGraphicsScale::applyTo ( <a href="qmatrix4x4.html">QMatrix4x4</a> * <i>matrix</i> ) const <tt> [virtual]</tt></h3> <p>Reimplemented from <a href="qgraphicstransform.html#applyTo">QGraphicsTransform::applyTo</a>().</p> <a name="//apple_ref/cpp/instm/QGraphicsScale/originChanged"></a> <h3 class="fn"><a name="originChanged"></a>void QGraphicsScale::originChanged () <tt> [signal]</tt></h3> <p><a href="qgraphicsscale.html">QGraphicsScale</a> emits this signal when its origin changes.</p> <p>See also <a href="qgraphicsscale.html#origin-prop">QGraphicsScale::origin</a>.</p> <a name="//apple_ref/cpp/instm/QGraphicsScale/scaleChanged"></a> <h3 class="fn"><a name="scaleChanged"></a>void QGraphicsScale::scaleChanged () <tt> [signal]</tt></h3> <p>This signal is emitted whenever the <a href="qgraphicsscale.html#xScale-prop">xScale</a>, <a href="qgraphicsscale.html#yScale-prop">yScale</a>, or <a href="qgraphicsscale.html#zScale-prop">zScale</a> of the object changes.</p> <p>See also <a href="qgraphicsscale.html#xScale-prop">QGraphicsScale::xScale</a>, <a href="qgraphicsscale.html#yScale-prop">QGraphicsScale::yScale</a>, and <a href="qgraphicsscale.html#zScale-prop">QGraphicsScale::zScale</a>.</p> <p /><address><hr /><div align="center"> <table width="100%" cellspacing="0" border="0"><tr class="address"> <td width="40%" align="left">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies)</td> <td width="20%" align="center"><a href="trademarks.html">Trademarks</a></td> <td width="40%" align="right"><div align="right">Qt 4.6.3</div></td> </tr></table></div></address></body> </html>