Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
QQuickImageParticle Class Reference

#include <qquickimageparticle_p.h>

+ Inheritance diagram for QQuickImageParticle:
+ Collaboration diagram for QQuickImageParticle:

Public Types

enum  Status { Null , Ready , Loading , Error }
 
enum  EntryEffect { None = 0 , Fade = 1 , Scale = 2 }
 
enum  PerformanceLevel {
  Unknown = 0 , SimplePoint , ColoredPoint , Colored ,
  Deformable , Tabled , Sprites
}
 
- Public Types inherited from QQuickParticlePainter
typedef QQuickParticleVarLengthArray< QQuickParticleGroupData::ID, 4 > GroupIDs
 
- Public Types inherited from QQuickItem
enum  Flag {
  ItemClipsChildrenToShape = 0x01 , ItemIsFocusScope = 0x04 , ItemHasContents = 0x08 , ItemAcceptsDrops = 0x10 ,
  ItemIsViewport = 0x20 , ItemObservesViewport = 0x40
}
 \qmltype Item \nativetype QQuickItem \inherits QtObject \inqmlmodule QtQuick More...
 
enum  ItemChange {
  ItemChildAddedChange , ItemChildRemovedChange , ItemSceneChange , ItemVisibleHasChanged ,
  ItemParentHasChanged , ItemOpacityHasChanged , ItemActiveFocusHasChanged , ItemRotationHasChanged ,
  ItemAntialiasingHasChanged , ItemDevicePixelRatioHasChanged , ItemEnabledHasChanged , ItemScaleHasChanged ,
  ItemTransformHasChanged
}
 Used in conjunction with QQuickItem::itemChange() to notify the item about certain types of changes. More...
 
enum  TransformOrigin {
  TopLeft , Top , TopRight , Left ,
  Center , Right , BottomLeft , Bottom ,
  BottomRight
}
 \variable QQuickItem::ItemChangeData::realValue The numeric value that has changed: \l {QQuickItem::opacity()}{opacity}, \l {QQuickItem::rotation()}{rotation}, or \l {QQuickItem::scale()}{scale}, or \l {QScreen::devicePixelRatio}{device pixel ratio}. More...
 

Public Slots

void setAlphaVariation (qreal arg)
 
void setAlpha (qreal arg)
 
void setRedVariation (qreal arg)
 
void setGreenVariation (qreal arg)
 
void setBlueVariation (qreal arg)
 
void setRotation (qreal arg)
 
void setRotationVariation (qreal arg)
 
void setRotationVelocity (qreal arg)
 
void setRotationVelocityVariation (qreal arg)
 
void setAutoRotation (bool arg)
 
void setXVector (QQuickDirection *arg)
 
void setYVector (QQuickDirection *arg)
 
void setSpritesInterpolate (bool arg)
 
void setBypassOptimizations (bool arg)
 
void setEntryEffect (EntryEffect arg)
 
- Public Slots inherited from QQuickParticlePainter
void setSystem (QQuickParticleSystem *arg)
 
void setGroups (const QStringList &arg)
 
void calcSystemOffset (bool resetPending=false)
 
- Public Slots inherited from QQuickItem
void update ()
 Schedules a call to updatePaintNode() for this item.
 
- Public Slots inherited from QObject
void deleteLater ()
 \threadsafe
 

Signals

void imageChanged ()
 
void colortableChanged ()
 
void sizetableChanged ()
 
void opacitytableChanged ()
 
void colorChanged ()
 
void colorVariationChanged ()
 
void alphaVariationChanged (qreal arg)
 
void alphaChanged (qreal arg)
 
void redVariationChanged (qreal arg)
 
void greenVariationChanged (qreal arg)
 
void blueVariationChanged (qreal arg)
 
void rotationChanged (qreal arg)
 
void rotationVariationChanged (qreal arg)
 
void rotationVelocityChanged (qreal arg)
 
void rotationVelocityVariationChanged (qreal arg)
 
void autoRotationChanged (bool arg)
 
void xVectorChanged (QQuickDirection *arg)
 
void yVectorChanged (QQuickDirection *arg)
 
void spritesInterpolateChanged (bool arg)
 
void bypassOptimizationsChanged (bool arg)
 
void entryEffectChanged (EntryEffect arg)
 
void statusChanged (Status arg)
 
- Signals inherited from QQuickParticlePainter
void countChanged ()
 
void systemChanged (QQuickParticleSystem *arg)
 
void groupsChanged (const QStringList &arg)
 
- Signals inherited from QQuickItem
void childrenRectChanged (const QRectF &)
 
void baselineOffsetChanged (qreal)
 
void stateChanged (const QString &)
 
void focusChanged (bool)
 
void activeFocusChanged (bool)
 
Q_REVISION(6, 7) void focusPolicyChanged(Qt Q_REVISION (2, 1) void activeFocusOnTabChanged(bool)
 
void parentChanged (QQuickItem *)
 
void transformOriginChanged (TransformOrigin)
 
void smoothChanged (bool)
 
void antialiasingChanged (bool)
 
void clipChanged (bool)
 
 Q_REVISION (2, 1) void windowChanged(QQuickWindow *window)
 
void childrenChanged ()
 
void opacityChanged ()
 
void enabledChanged ()
 
void visibleChanged ()
 
void visibleChildrenChanged ()
 
void rotationChanged ()
 
void scaleChanged ()
 
void xChanged ()
 
void yChanged ()
 
void widthChanged ()
 
void heightChanged ()
 
void zChanged ()
 
void implicitWidthChanged ()
 
void implicitHeightChanged ()
 
 Q_REVISION (2, 11) void containmentMaskChanged()
 
 Q_REVISION (6, 0) void paletteChanged()
 
 Q_REVISION (6, 0) void paletteCreated()
 
- Signals inherited from QObject
void destroyed (QObject *=nullptr)
 This signal is emitted immediately before the object obj is destroyed, after any instances of QPointer have been notified, and cannot be blocked.
 
void objectNameChanged (const QString &objectName, QPrivateSignal)
 This signal is emitted after the object's name has been changed.
 

Public Member Functions

 QQuickImageParticle (QQuickItem *parent=nullptr)
 \qmltype ImageParticle \nativetype QQuickImageParticle \inqmlmodule QtQuick.Particles \inherits ParticlePainter
 
virtual ~QQuickImageParticle ()
 
QQmlListProperty< QQuickSpritesprites ()
 
QQuickStochasticEnginespriteEngine ()
 
QUrl image () const
 
void setImage (const QUrl &image)
 
QUrl colortable () const
 
void setColortable (const QUrl &table)
 
QUrl sizetable () const
 
void setSizetable (const QUrl &table)
 
QUrl opacitytable () const
 
void setOpacitytable (const QUrl &table)
 
QColor color () const
 
void setColor (const QColor &color)
 
qreal colorVariation () const
 
void setColorVariation (qreal var)
 
qreal alphaVariation () const
 
qreal alpha () const
 
qreal redVariation () const
 
qreal greenVariation () const
 
qreal blueVariation () const
 
qreal rotation () const
 
qreal rotationVariation () const
 
qreal rotationVelocity () const
 
qreal rotationVelocityVariation () const
 
bool autoRotation () const
 
QQuickDirectionxVector () const
 
QQuickDirectionyVector () const
 
bool spritesInterpolate () const
 
bool bypassOptimizations () const
 
EntryEffect entryEffect () const
 
Status status () const
 
void resetColor ()
 
void resetRotation ()
 
void resetDeformation ()
 
- Public Member Functions inherited from QQuickParticlePainter
 QQuickParticlePainter (QQuickItem *parent=nullptr)
 \qmltype ParticlePainter \nativetype QQuickParticlePainter \inqmlmodule QtQuick.Particles \inherits Item
 
void load (QQuickParticleData *)
 
void reload (QQuickParticleData *)
 
void setCount (int c)
 
int count () const
 
void performPendingCommits ()
 
QQuickParticleSystemsystem () const
 
QStringList groups () const
 
const GroupIDsgroupIds () const
 
void itemChange (ItemChange, const ItemChangeData &) override
 Called when change occurs for this item.
 
- Public Member Functions inherited from QQuickItem
 QQuickItem (QQuickItem *parent=nullptr)
 Constructs a QQuickItem with the given parent.
 
 ~QQuickItem () override
 Destroys the QQuickItem.
 
QQuickWindowwindow () const
 Returns the window in which this item is rendered.
 
QQuickItemparentItem () const
 
void setParentItem (QQuickItem *parent)
 
void stackBefore (const QQuickItem *)
 Moves the specified sibling item to the index before this item within the list of children.
 
void stackAfter (const QQuickItem *)
 Moves the specified sibling item to the index after this item within the list of children.
 
QRectF childrenRect ()
 \qmlpropertygroup QtQuick::Item::childrenRect \qmlproperty real QtQuick::Item::childrenRect.x \qmlproperty real QtQuick::Item::childrenRect.y \qmlproperty real QtQuick::Item::childrenRect.width \qmlproperty real QtQuick::Item::childrenRect.height \readonly
 
QList< QQuickItem * > childItems () const
 Returns the children of this item.
 
bool clip () const
 \qmlproperty bool QtQuick::Item::clip This property holds whether clipping is enabled.
 
void setClip (bool)
 
QString state () const
 \qmlproperty string QtQuick::Item::state
 
void setState (const QString &)
 
qreal baselineOffset () const
 \qmlproperty int QtQuick::Item::baselineOffset
 
void setBaselineOffset (qreal)
 
QQmlListProperty< QQuickTransformtransform ()
 
qreal x () const
 
qreal y () const
 
QPointF position () const
 
void setX (qreal)
 
void setY (qreal)
 
void setPosition (const QPointF &)
 
QBindable< qrealbindableX ()
 
QBindable< qrealbindableY ()
 
qreal width () const
 
void setWidth (qreal)
 
void resetWidth ()
 
void setImplicitWidth (qreal)
 
qreal implicitWidth () const
 Returns the width of the item that is implied by other properties that determine the content.
 
QBindable< qrealbindableWidth ()
 
qreal height () const
 
void setHeight (qreal)
 
void resetHeight ()
 
void setImplicitHeight (qreal)
 
qreal implicitHeight () const
 
QBindable< qrealbindableHeight ()
 
QSizeF size () const
 
void setSize (const QSizeF &size)
 
TransformOrigin transformOrigin () const
 
void setTransformOrigin (TransformOrigin)
 
QPointF transformOriginPoint () const
 
void setTransformOriginPoint (const QPointF &)
 
qreal z () const
 
void setZ (qreal)
 
qreal rotation () const
 
void setRotation (qreal)
 
qreal scale () const
 
void setScale (qreal)
 
qreal opacity () const
 
void setOpacity (qreal)
 
bool isVisible () const
 
void setVisible (bool)
 
bool isEnabled () const
 
void setEnabled (bool)
 
bool smooth () const
 
void setSmooth (bool)
 
bool activeFocusOnTab () const
 \qmlproperty bool QtQuick::Item::activeFocusOnTab
 
void setActiveFocusOnTab (bool)
 
bool antialiasing () const
 
void setAntialiasing (bool)
 
void resetAntialiasing ()
 
Flags flags () const
 Returns the item flags for this item.
 
void setFlag (Flag flag, bool enabled=true)
 Enables the specified flag for this item if enabled is true; if enabled is false, the flag is disabled.
 
void setFlags (Flags flags)
 Enables the specified flags for this item.
 
virtual QRectF boundingRect () const
 Returns the extents of the item in its own coordinate system: a rectangle from {0, 0} to \l width() and \l height().
 
virtual QRectF clipRect () const
 Returns the rectangular area within this item that is currently visible in \l viewportItem(), if there is a viewport and the \l ItemObservesViewport flag is set; otherwise, the extents of this item in its own coordinate system: a rectangle from {0, 0} to \l width() and \l height().
 
QQuickItemviewportItem () const
 If the \l ItemObservesViewport flag is set, returns the nearest parent with the \l ItemIsViewport flag.
 
bool hasActiveFocus () const
 
bool hasFocus () const
 
void setFocus (bool)
 
void setFocus (bool focus, Qt::FocusReason reason)
 
bool isFocusScope () const
 Returns true if this item is a focus scope, and false otherwise.
 
QQuickItemscopedFocusItem () const
 If this item is a focus scope, this returns the item in its focus chain that currently has focus.
 
Qt::FocusPolicy focusPolicy () const
 
void setFocusPolicy (Qt::FocusPolicy policy)
 Sets the focus policy of this item to policy.
 
bool isAncestorOf (const QQuickItem *child) const
 Returns true if this item is an ancestor of child (i.e., if this item is child's parent, or one of child's parent's ancestors).
 
Qt::MouseButtons acceptedMouseButtons () const
 Returns the mouse buttons accepted by this item.
 
void setAcceptedMouseButtons (Qt::MouseButtons buttons)
 Sets the mouse buttons accepted by this item to buttons.
 
bool acceptHoverEvents () const
 Returns whether hover events are accepted by this item.
 
void setAcceptHoverEvents (bool enabled)
 If enabled is true, this sets the item to accept hover events; otherwise, hover events are not accepted by this item.
 
bool acceptTouchEvents () const
 Returns whether touch events are accepted by this item.
 
void setAcceptTouchEvents (bool accept)
 If enabled is true, this sets the item to accept touch events; otherwise, touch events are not accepted by this item.
 
bool isUnderMouse () const
 
void grabMouse ()
 
void ungrabMouse ()
 
bool keepMouseGrab () const
 Returns whether mouse input should exclusively remain with this item.
 
void setKeepMouseGrab (bool)
 Sets whether the mouse input should remain exclusively with this item.
 
bool filtersChildMouseEvents () const
 Returns whether pointer events intended for this item's children should be filtered through this item.
 
void setFiltersChildMouseEvents (bool filter)
 Sets whether pointer events intended for this item's children should be filtered through this item.
 
void grabTouchPoints (const QList< int > &ids)
 
void ungrabTouchPoints ()
 
bool keepTouchGrab () const
 Returns whether the touch points grabbed by this item should exclusively remain with this item.
 
void setKeepTouchGrab (bool)
 Sets whether the touch points grabbed by this item should remain exclusively with this item.
 
 Q_REVISION (2, 4) Q_INVOKABLE bool grabToImage(const QJSValue &callback
 
QSharedPointer< QQuickItemGrabResultgrabToImage (const QSize &targetSize=QSize())
 Grabs the item into an in-memory image.
 
virtual Q_INVOKABLE bool contains (const QPointF &point) const
 \qmlmethod bool QtQuick::Item::contains(point point)
 
QObjectcontainmentMask () const
 
void setContainmentMask (QObject *mask)
 
QTransform itemTransform (QQuickItem *, bool *) const
 \qmlmethod point QtQuick::Item::mapFromItem(Item item, real x, real y) \qmlmethod point QtQuick::Item::mapFromItem(Item item, point p) \qmlmethod rect QtQuick::Item::mapFromItem(Item item, real x, real y, real width, real height) \qmlmethod rect QtQuick::Item::mapFromItem(Item item, rect r)
 
QPointF mapToScene (const QPointF &point) const
 Maps the given point in this item's coordinate system to the equivalent point within the scene's coordinate system, and returns the mapped coordinate.
 
QRectF mapRectToItem (const QQuickItem *item, const QRectF &rect) const
 Maps the given rect in this item's coordinate system to the equivalent rectangular area within item's coordinate system, and returns the mapped rectangle value.
 
QRectF mapRectToScene (const QRectF &rect) const
 Maps the given rect in this item's coordinate system to the equivalent rectangular area within the scene's coordinate system, and returns the mapped rectangle value.
 
QPointF mapFromScene (const QPointF &point) const
 Maps the given point in the scene's coordinate system to the equivalent point within this item's coordinate system, and returns the mapped coordinate.
 
QRectF mapRectFromItem (const QQuickItem *item, const QRectF &rect) const
 Maps the given rect in item's coordinate system to the equivalent rectangular area within this item's coordinate system, and returns the mapped rectangle value.
 
QRectF mapRectFromScene (const QRectF &rect) const
 Maps the given rect in the scene's coordinate system to the equivalent rectangular area within this item's coordinate system, and returns the mapped rectangle value.
 
void polish ()
 Schedules a polish event for this item.
 
Q_INVOKABLE QPointF mapFromItem (const QQuickItem *item, const QPointF &point) const
 Maps the given point in item's coordinate system to the equivalent point within this item's coordinate system, and returns the mapped coordinate.
 
Q_INVOKABLE QPointF mapFromItem (const QQuickItem *item, qreal x, qreal y)
 
Q_INVOKABLE QRectF mapFromItem (const QQuickItem *item, const QRectF &rect) const
 
Q_INVOKABLE QRectF mapFromItem (const QQuickItem *item, qreal x, qreal y, qreal width, qreal height) const
 
Q_INVOKABLE QPointF mapToItem (const QQuickItem *item, const QPointF &point) const
 Maps the given point in this item's coordinate system to the equivalent point within item's coordinate system, and returns the mapped coordinate.
 
Q_INVOKABLE QPointF mapToItem (const QQuickItem *item, qreal x, qreal y)
 
Q_INVOKABLE QRectF mapToItem (const QQuickItem *item, const QRectF &rect) const
 
Q_INVOKABLE QRectF mapToItem (const QQuickItem *item, qreal x, qreal y, qreal width, qreal height) const
 
 Q_REVISION (2, 7) Q_INVOKABLE QPointF mapFromGlobal(qreal x
 
 Q_REVISION (2, 7) Q_INVOKABLE QPointF mapFromGlobal(const QPointF &point) const
 
 Q_REVISION (2, 7) Q_INVOKABLE QPointF mapToGlobal(qreal x
 
 Q_REVISION (2, 7) Q_INVOKABLE QPointF mapToGlobal(const QPointF &point) const
 
Q_INVOKABLE void forceActiveFocus ()
 \qmlmethod point QtQuick::Item::mapToItem(Item item, real x, real y) \qmlmethod point QtQuick::Item::mapToItem(Item item, point p) \qmlmethod rect QtQuick::Item::mapToItem(Item item, real x, real y, real width, real height) \qmlmethod rect QtQuick::Item::mapToItem(Item item, rect r)
 
Q_INVOKABLE void forceActiveFocus (Qt::FocusReason reason)
 \qmlmethod QtQuick::Item::forceActiveFocus(Qt::FocusReason reason) This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.Forces active focus on the item with the given reason.
 
 Q_REVISION (2, 1) Q_INVOKABLE QQuickItem *nextItemInFocusChain(bool forward
 
Q_INVOKABLE QQuickItemchildAt (qreal x, qreal y) const
 \qmlmethod QtQuick::Item::childAt(real x, real y)
 
 Q_REVISION (6, 3) Q_INVOKABLE void ensurePolished()
 
 Q_REVISION (6, 3) Q_INVOKABLE void dumpItemTree() const
 
virtual bool isTextureProvider () const
 Returns true if this item is a texture provider.
 
virtual QSGTextureProvidertextureProvider () const
 Returns the texture provider for an item.
 
- Public Member Functions inherited from QObject
Q_INVOKABLE QObject (QObject *parent=nullptr)
 Constructs an object with parent object parent.
 
virtual ~QObject ()
 Destroys the object, deleting all its child objects.
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 Filters events if this object has been installed as an event filter for the watched object.
 
QString objectName () const
 
Q_WEAK_OVERLOAD void setObjectName (const QString &name)
 Sets the object's name to name.
 
void setObjectName (QAnyStringView name)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
 
QBindable< QStringbindableObjectName ()
 
bool isWidgetType () const
 Returns true if the object is a widget; otherwise returns false.
 
bool isWindowType () const
 Returns true if the object is a window; otherwise returns false.
 
bool isQuickItemType () const
 Returns true if the object is a QQuickItem; otherwise returns false.
 
bool signalsBlocked () const noexcept
 Returns true if signals are blocked; otherwise returns false.
 
bool blockSignals (bool b) noexcept
 If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it).
 
QThreadthread () const
 Returns the thread in which the object lives.
 
bool moveToThread (QThread *thread QT6_DECL_NEW_OVERLOAD_TAIL)
 Changes the thread affinity for this object and its children and returns true on success.
 
int startTimer (int interval, Qt::TimerType timerType=Qt::CoarseTimer)
 This is an overloaded function that will start a timer of type timerType and a timeout of interval milliseconds.
 
int startTimer (std::chrono::nanoseconds time, Qt::TimerType timerType=Qt::CoarseTimer)
 
void killTimer (int id)
 Kills the timer with timer identifier, id.
 
void killTimer (Qt::TimerId id)
 
template<typename T >
findChild (QAnyStringView aName, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 Returns the child of this object that can be cast into type T and that is called name, or \nullptr if there is no such object.
 
template<typename T >
QList< T > findChildren (QAnyStringView aName, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects.
 
template<typename T >
findChild (Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
 
template<typename T >
QList< T > findChildren (Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
 
const QObjectListchildren () const
 Returns a list of child objects.
 
void setParent (QObject *parent)
 Makes the object a child of parent.
 
void installEventFilter (QObject *filterObj)
 Installs an event filter filterObj on this object.
 
void removeEventFilter (QObject *obj)
 Removes an event filter object obj from this object.
 
QMetaObject::Connection connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const
 
bool disconnect (const char *signal=nullptr, const QObject *receiver=nullptr, const char *member=nullptr) const
 
bool disconnect (const QObject *receiver, const char *member=nullptr) const
 
void dumpObjectTree () const
 Dumps a tree of children to the debug output.
 
void dumpObjectInfo () const
 Dumps information about signal connections, etc.
 
bool setProperty (const char *name, const QVariant &value)
 Sets the value of the object's name property to value.
 
bool setProperty (const char *name, QVariant &&value)
 
QVariant property (const char *name) const
 Returns the value of the object's name property.
 
QList< QByteArraydynamicPropertyNames () const
 
QBindingStoragebindingStorage ()
 
const QBindingStoragebindingStorage () const
 
QObjectparent () const
 Returns a pointer to the parent object.
 
bool inherits (const char *classname) const
 Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false.
 
- Public Member Functions inherited from QQmlParserStatus
 QQmlParserStatus ()
 
virtual ~QQmlParserStatus ()
 

Protected Member Functions

void reset () override
 
void initialize (int gIdx, int pIdx) override
 
void commit (int gIdx, int pIdx) override
 
QSGNodeupdatePaintNode (QSGNode *, UpdatePaintNodeData *) override
 Called on the render thread when it is time to sync the state of the item with the scene graph.
 
bool prepareNextFrame (QSGNode **)
 
void buildParticleNodes (QSGNode **)
 
void sceneGraphInvalidated () override
 
- Protected Member Functions inherited from QQuickParticlePainter
void componentComplete () override
 \reimp Derived classes should call the base class method before adding their own actions to perform at componentComplete.
 
- Protected Member Functions inherited from QQuickItem
bool event (QEvent *) override
 \reimp
 
bool isComponentComplete () const
 Returns true if construction of the QML component is complete; otherwise returns false.
 
virtual void geometryChange (const QRectF &newGeometry, const QRectF &oldGeometry)
 
bool widthValid () const
 Returns whether the width property has been set explicitly.
 
bool heightValid () const
 Returns whether the height property has been set explicitly.
 
void setImplicitSize (qreal, qreal)
 
void classBegin () override
 \reimp Derived classes should call the base class method before adding their own action to perform at classBegin.
 
virtual void keyPressEvent (QKeyEvent *event)
 This event handler can be reimplemented in a subclass to receive key press events for an item.
 
virtual void keyReleaseEvent (QKeyEvent *event)
 This event handler can be reimplemented in a subclass to receive key release events for an item.
 
virtual void focusInEvent (QFocusEvent *)
 This event handler can be reimplemented in a subclass to receive focus-in events for an item.
 
virtual void focusOutEvent (QFocusEvent *)
 This event handler can be reimplemented in a subclass to receive focus-out events for an item.
 
virtual void mousePressEvent (QMouseEvent *event)
 This event handler can be reimplemented in a subclass to receive mouse press events for an item.
 
virtual void mouseMoveEvent (QMouseEvent *event)
 This event handler can be reimplemented in a subclass to receive mouse move events for an item.
 
virtual void mouseReleaseEvent (QMouseEvent *event)
 This event handler can be reimplemented in a subclass to receive mouse release events for an item.
 
virtual void mouseDoubleClickEvent (QMouseEvent *event)
 This event handler can be reimplemented in a subclass to receive mouse double-click events for an item.
 
virtual void mouseUngrabEvent ()
 This event handler can be reimplemented in a subclass to be notified when a mouse ungrab event has occurred on this item.
 
virtual void touchUngrabEvent ()
 This event handler can be reimplemented in a subclass to be notified when a touch ungrab event has occurred on this item.
 
virtual void touchEvent (QTouchEvent *event)
 This event handler can be reimplemented in a subclass to receive touch events for an item.
 
virtual void hoverEnterEvent (QHoverEvent *event)
 This event handler can be reimplemented in a subclass to receive hover-enter events for an item.
 
virtual void hoverMoveEvent (QHoverEvent *event)
 This event handler can be reimplemented in a subclass to receive hover-move events for an item.
 
virtual void hoverLeaveEvent (QHoverEvent *event)
 This event handler can be reimplemented in a subclass to receive hover-leave events for an item.
 
virtual bool childMouseEventFilter (QQuickItem *, QEvent *)
 Reimplement this method to filter the pointer events that are received by this item's children.
 
virtual void releaseResources ()
 This function is called when an item should release graphics resources which are not already managed by the nodes returned from QQuickItem::updatePaintNode().
 
virtual void updatePolish ()
 This function should perform any layout as required for this item.
 
 QQuickItem (QQuickItemPrivate &dd, QQuickItem *parent=nullptr)
 
- Protected Member Functions inherited from QObject
QObjectsender () const
 Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns \nullptr.
 
int senderSignalIndex () const
 
int receivers (const char *signal) const
 Returns the number of receivers connected to the signal.
 
bool isSignalConnected (const QMetaMethod &signal) const
 
virtual void timerEvent (QTimerEvent *event)
 This event handler can be reimplemented in a subclass to receive timer events for the object.
 
virtual void childEvent (QChildEvent *event)
 This event handler can be reimplemented in a subclass to receive child events.
 
virtual void customEvent (QEvent *event)
 This event handler can be reimplemented in a subclass to receive custom events.
 
virtual void connectNotify (const QMetaMethod &signal)
 
virtual void disconnectNotify (const QMetaMethod &signal)
 
 QObject (QObjectPrivate &dd, QObject *parent=nullptr)
 

Properties

QUrl source
 
QQmlListProperty< QQuickSpritesprites
 
Status status
 
QUrl colorTable
 
QUrl sizeTable
 
QUrl opacityTable
 
QColor color
 
qreal colorVariation
 
qreal redVariation
 
qreal greenVariation
 
qreal blueVariation
 
qreal alpha
 
qreal alphaVariation
 
qreal rotation
 
qreal rotationVariation
 
qreal rotationVelocity
 
qreal rotationVelocityVariation
 
bool autoRotation
 
QQuickDirectionxVector
 
QQuickDirectionyVector
 
bool spritesInterpolate
 
EntryEffect entryEffect
 
- Properties inherited from QQuickParticlePainter
QQuickParticleSystemsystem
 
QStringList groups
 
- Properties inherited from QQuickItem
QQuickItemparent
 \qmlproperty Item QtQuick::Item::parent This property holds the visual parent of the item.
 
qreal x
 \qmlproperty real QtQuick::Item::x \qmlproperty real QtQuick::Item::y \qmlproperty real QtQuick::Item::width \qmlproperty real QtQuick::Item::height
 
qreal y
 Defines the item's y position relative to its parent.
 
qreal z
 \qmlproperty real QtQuick::Item::z
 
qreal width
 This property holds the width of this item.
 
qreal height
 This property holds the height of this item.
 
qreal opacity
 \qmlproperty real QtQuick::Item::opacity
 
bool enabled
 \qmlproperty bool QtQuick::Item::enabled
 
bool visible
 \qmlproperty bool QtQuick::Item::visible
 
Qt::FocusPolicy focusPolicy
 \qmlproperty enumeration QtQuick::Item::focusPolicy
 
qreal rotation
 \qmlproperty real QtQuick::Item::rotation This property holds the rotation of the item in degrees clockwise around its transformOrigin.
 
qreal scale
 \qmlproperty real QtQuick::Item::scale This property holds the scale factor for this item.
 
TransformOrigin transformOrigin
 \qmlproperty enumeration QtQuick::Item::transformOrigin This property holds the origin point around which scale and rotation transform.
 
QPointF transformOriginPoint
 
QQmlListProperty< QQuickTransformtransform
 \qmlproperty list<Transform> QtQuick::Item::transform This property holds the list of transformations to apply.
 
bool smooth
 \qmlproperty bool QtQuick::Item::smooth
 
bool antialiasing
 \qmlproperty bool QtQuick::Item::antialiasing
 
qreal implicitWidth
 
qreal implicitHeight
 
QObjectcontainmentMask
 \qmlproperty QObject* QtQuick::Item::containmentMask
 
- Properties inherited from QObject
QString objectName
 the name of this object
 

Additional Inherited Members

- Static Public Member Functions inherited from QObject
static QMetaObject::Connection connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection)
 \threadsafe
 
static QMetaObject::Connection connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection)
 
template<typename Func1 , typename Func2 >
static QMetaObject::Connection connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::ContextTypeForFunctor< Func2 >::ContextType *context, Func2 &&slot, Qt::ConnectionType type=Qt::AutoConnection)
 
template<typename Func1 , typename Func2 >
static QMetaObject::Connection connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, Func2 &&slot)
 
static bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member)
 \threadsafe
 
static bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member)
 
static bool disconnect (const QMetaObject::Connection &)
 Disconnect a connection.
 
template<typename Func1 , typename Func2 >
static bool disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::FunctionPointer< Func2 >::Object *receiver, Func2 slot)
 
template<typename Func1 >
static bool disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const QObject *receiver, void **zero)
 
- Public Attributes inherited from QQuickItem
const QSizetargetSize = QSize())
 
qreal y const
 
- Protected Attributes inherited from QQuickParticlePainter
QQuickParticleSystemm_system
 
int m_count
 
bool m_pleaseReset
 
QPointF m_systemOffset
 
QQuickWindowm_window
 
bool m_windowChanged
 
- Protected Attributes inherited from QObject
QScopedPointer< QObjectDatad_ptr
 

Detailed Description

Definition at line 149 of file qquickimageparticle_p.h.

Member Enumeration Documentation

◆ EntryEffect

Enumerator
None 
Fade 
Scale 

Definition at line 200 of file qquickimageparticle_p.h.

◆ PerformanceLevel

Enumerator
Unknown 
SimplePoint 
ColoredPoint 
Colored 
Deformable 
Tabled 
Sprites 

Definition at line 207 of file qquickimageparticle_p.h.

◆ Status

Enumerator
Null 
Ready 
Loading 
Error 

Definition at line 194 of file qquickimageparticle_p.h.

Constructor & Destructor Documentation

◆ QQuickImageParticle()

QQuickImageParticle::QQuickImageParticle ( QQuickItem * parent = nullptr)
explicit

\qmltype ImageParticle \nativetype QQuickImageParticle \inqmlmodule QtQuick.Particles \inherits ParticlePainter

For visualizing logical particles using an image.

This element renders a logical particle as an image. The image can be \list

  • colorized
  • rotated
  • deformed
  • a sprite-based animation \endlist

ImageParticles implictly share data on particles if multiple ImageParticles are painting the same logical particle group. This is broken down along the four capabilities listed above. So if one ImageParticle defines data for rendering the particles in one of those capabilities, and the other does not, then both will draw the particles the same in that aspect automatically. This is primarily useful when there is some random variation on the particle which is supposed to stay with it when switching painters. If both ImageParticles define how they should appear for that aspect, they diverge and each appears as it is defined.

This sharing of data happens behind the scenes based off of whether properties were implicitly or explicitly set. One drawback of the current implementation is that it is only possible to reset the capabilities as a whole. So if you explicitly set an attribute affecting color, such as redVariation, and then reset it (by setting redVariation to undefined), all color data will be reset and it will begin to have an implicit value of any shared color from other ImageParticles.

Note
The maximum number of image particles is limited to 16383.

\qmlproperty url QtQuick.Particles::ImageParticle::source

The source image to be used.

If the image is a sprite animation, use the sprite property instead.

Since Qt 5.2, some default images are provided as resources to aid prototyping: \table \row

  • qrc:///particleresources/star.png
  • \inlineimage particles/star.png \row
  • qrc:///particleresources/glowdot.png
  • \inlineimage particles/glowdot.png \row
  • qrc:///particleresources/fuzzydot.png
  • \inlineimage particles/fuzzydot.png \endtable

Note that the images are white and semi-transparent, to allow colorization and alpha levels to have maximum effect.

\qmlproperty list<Sprite> QtQuick.Particles::ImageParticle::sprites

The sprite or sprites used to draw this particle.

Note that the sprite image will be scaled to a square based on the size of the particle being rendered.

For full details, see the \l{Sprite Animations} overview.

\qmlproperty url QtQuick.Particles::ImageParticle::colorTable

An image whose color will be used as a 1D texture to determine color over life. E.g. when the particle is halfway through its lifetime, it will have the color specified halfway across the image.

This color is blended with the color property and the color of the source image.

\qmlproperty url QtQuick.Particles::ImageParticle::sizeTable

An image whose opacity will be used as a 1D texture to determine size over life.

This property is expected to be removed shortly, in favor of custom easing curves to determine size over life.

\qmlproperty url QtQuick.Particles::ImageParticle::opacityTable

An image whose opacity will be used as a 1D texture to determine size over life.

This property is expected to be removed shortly, in favor of custom easing curves to determine opacity over life.

\qmlproperty color QtQuick.Particles::ImageParticle::color

If a color is specified, the provided image will be colorized with it.

Default is white (no change).

\qmlproperty real QtQuick.Particles::ImageParticle::colorVariation

This number represents the color variation applied to individual particles. Setting colorVariation is the same as setting redVariation, greenVariation, and blueVariation to the same number.

Each channel can vary between particle by up to colorVariation from its usual color.

Color is measured, per channel, from 0.0 to 1.0.

Default is 0.0

\qmlproperty real QtQuick.Particles::ImageParticle::redVariation The variation in the red color channel between particles.

Color is measured, per channel, from 0.0 to 1.0.

Default is 0.0

\qmlproperty real QtQuick.Particles::ImageParticle::greenVariation The variation in the green color channel between particles.

Color is measured, per channel, from 0.0 to 1.0.

Default is 0.0

\qmlproperty real QtQuick.Particles::ImageParticle::blueVariation The variation in the blue color channel between particles.

Color is measured, per channel, from 0.0 to 1.0.

Default is 0.0

\qmlproperty real QtQuick.Particles::ImageParticle::alpha An alpha to be applied to the image. This value is multiplied by the value in the image, and the value in the color property.

Particles have additive blending, so lower alpha on single particles leads to stronger effects when multiple particles overlap.

Alpha is measured from 0.0 to 1.0.

Default is 1.0

\qmlproperty real QtQuick.Particles::ImageParticle::alphaVariation The variation in the alpha channel between particles.

Alpha is measured from 0.0 to 1.0.

Default is 0.0

\qmlproperty real QtQuick.Particles::ImageParticle::rotation

If set the image will be rotated by this many degrees before it is drawn.

The particle coordinates are not transformed.

\qmlproperty real QtQuick.Particles::ImageParticle::rotationVariation

If set the rotation of individual particles will vary by up to this much between particles.

\qmlproperty real QtQuick.Particles::ImageParticle::rotationVelocity

If set particles will rotate at this velocity in degrees/second.

\qmlproperty real QtQuick.Particles::ImageParticle::rotationVelocityVariation

If set the rotationVelocity of individual particles will vary by up to this much between particles.

\qmlproperty bool QtQuick.Particles::ImageParticle::autoRotation

If set to true then a rotation will be applied on top of the particles rotation, so that it faces the direction of travel. So to face away from the direction of travel, set autoRotation to true and rotation to 180.

Default is false

\qmlproperty StochasticDirection QtQuick.Particles::ImageParticle::xVector

Allows you to deform the particle image when drawn. The rectangular image will be deformed so that the horizontal sides are in the shape of this vector instead of (1,0).

\qmlproperty StochasticDirection QtQuick.Particles::ImageParticle::yVector

Allows you to deform the particle image when drawn. The rectangular image will be deformed so that the vertical sides are in the shape of this vector instead of (0,1).

\qmlproperty EntryEffect QtQuick.Particles::ImageParticle::entryEffect

This property provides basic and cheap entrance and exit effects for the particles. For fine-grained control, see sizeTable and opacityTable.

Acceptable values are

\value ImageParticle.None Particles just appear and disappear. \value ImageParticle.Fade Particles fade in from 0 opacity at the start of their life, and fade out to 0 at the end. \value ImageParticle.Scale Particles scale in from 0 size at the start of their life, and scale back to 0 at the end.

The default value is ImageParticle.Fade.

\qmlproperty bool QtQuick.Particles::ImageParticle::spritesInterpolate

If set to true, sprite particles will interpolate between sprite frames each rendered frame, making the sprites look smoother.

Default is true.

\qmlproperty Status QtQuick.Particles::ImageParticle::status

The status of loading the image.

Definition at line 700 of file qquickimageparticle.cpp.

◆ ~QQuickImageParticle()

QQuickImageParticle::~QQuickImageParticle ( )
virtual

Definition at line 737 of file qquickimageparticle.cpp.

Member Function Documentation

◆ alpha()

qreal QQuickImageParticle::alpha ( ) const
inline

Definition at line 237 of file qquickimageparticle_p.h.

◆ alphaChanged

void QQuickImageParticle::alphaChanged ( qreal arg)
signal

◆ alphaVariation()

qreal QQuickImageParticle::alphaVariation ( ) const
inline

Definition at line 235 of file qquickimageparticle_p.h.

◆ alphaVariationChanged

void QQuickImageParticle::alphaVariationChanged ( qreal arg)
signal

◆ autoRotation()

bool QQuickImageParticle::autoRotation ( ) const
inline

Definition at line 253 of file qquickimageparticle_p.h.

◆ autoRotationChanged

void QQuickImageParticle::autoRotationChanged ( bool arg)
signal

◆ blueVariation()

qreal QQuickImageParticle::blueVariation ( ) const
inline

Definition at line 243 of file qquickimageparticle_p.h.

◆ blueVariationChanged

void QQuickImageParticle::blueVariationChanged ( qreal arg)
signal

◆ buildParticleNodes()

void QQuickImageParticle::buildParticleNodes ( QSGNode ** passThrough)
protected

Definition at line 1242 of file qquickimageparticle.cpp.

◆ bypassOptimizations()

bool QQuickImageParticle::bypassOptimizations ( ) const
inline

Definition at line 261 of file qquickimageparticle_p.h.

◆ bypassOptimizationsChanged

void QQuickImageParticle::bypassOptimizationsChanged ( bool arg)
signal

◆ color()

QColor QQuickImageParticle::color ( ) const
inline

Definition at line 229 of file qquickimageparticle_p.h.

◆ colorChanged

void QQuickImageParticle::colorChanged ( )
signal

◆ colortable()

QUrl QQuickImageParticle::colortable ( ) const
inline

Definition at line 220 of file qquickimageparticle_p.h.

◆ colortableChanged

void QQuickImageParticle::colortableChanged ( )
signal

◆ colorVariation()

qreal QQuickImageParticle::colorVariation ( ) const
inline

Definition at line 232 of file qquickimageparticle_p.h.

◆ colorVariationChanged

void QQuickImageParticle::colorVariationChanged ( )
signal

◆ commit()

void QQuickImageParticle::commit ( int gIdx,
int pIdx )
overrideprotectedvirtual

Reimplemented from QQuickParticlePainter.

Definition at line 1865 of file qquickimageparticle.cpp.

◆ entryEffect()

EntryEffect QQuickImageParticle::entryEffect ( ) const
inline

Definition at line 263 of file qquickimageparticle_p.h.

◆ entryEffectChanged

void QQuickImageParticle::entryEffectChanged ( EntryEffect arg)
signal

◆ greenVariation()

qreal QQuickImageParticle::greenVariation ( ) const
inline

Definition at line 241 of file qquickimageparticle_p.h.

◆ greenVariationChanged

void QQuickImageParticle::greenVariationChanged ( qreal arg)
signal

◆ image()

QUrl QQuickImageParticle::image ( ) const
inline

Definition at line 217 of file qquickimageparticle_p.h.

◆ imageChanged

void QQuickImageParticle::imageChanged ( )
signal

◆ initialize()

void QQuickImageParticle::initialize ( int gIdx,
int pIdx )
overrideprotectedvirtual

Reimplemented from QQuickParticlePainter.

Definition at line 1737 of file qquickimageparticle.cpp.

◆ opacitytable()

QUrl QQuickImageParticle::opacitytable ( ) const
inline

Definition at line 226 of file qquickimageparticle_p.h.

◆ opacitytableChanged

void QQuickImageParticle::opacitytableChanged ( )
signal

◆ prepareNextFrame()

bool QQuickImageParticle::prepareNextFrame ( QSGNode ** node)
protected

Definition at line 1586 of file qquickimageparticle.cpp.

◆ redVariation()

qreal QQuickImageParticle::redVariation ( ) const
inline

Definition at line 239 of file qquickimageparticle_p.h.

◆ redVariationChanged

void QQuickImageParticle::redVariationChanged ( qreal arg)
signal

◆ reset()

void QQuickImageParticle::reset ( )
overrideprotectedvirtual

Reimplemented from QQuickParticlePainter.

Definition at line 1057 of file qquickimageparticle.cpp.

◆ resetColor()

void QQuickImageParticle::resetColor ( )

Definition at line 1003 of file qquickimageparticle.cpp.

◆ resetDeformation()

void QQuickImageParticle::resetDeformation ( )

Definition at line 1039 of file qquickimageparticle.cpp.

◆ resetRotation()

void QQuickImageParticle::resetRotation ( )

Definition at line 1022 of file qquickimageparticle.cpp.

◆ rotation()

qreal QQuickImageParticle::rotation ( ) const
inline

Definition at line 245 of file qquickimageparticle_p.h.

◆ rotationChanged

void QQuickImageParticle::rotationChanged ( qreal arg)
signal

◆ rotationVariation()

qreal QQuickImageParticle::rotationVariation ( ) const
inline

Definition at line 247 of file qquickimageparticle_p.h.

◆ rotationVariationChanged

void QQuickImageParticle::rotationVariationChanged ( qreal arg)
signal

◆ rotationVelocity()

qreal QQuickImageParticle::rotationVelocity ( ) const
inline

Definition at line 249 of file qquickimageparticle_p.h.

◆ rotationVelocityChanged

void QQuickImageParticle::rotationVelocityChanged ( qreal arg)
signal

◆ rotationVelocityVariation()

qreal QQuickImageParticle::rotationVelocityVariation ( ) const
inline

Definition at line 251 of file qquickimageparticle_p.h.

◆ rotationVelocityVariationChanged

void QQuickImageParticle::rotationVelocityVariationChanged ( qreal arg)
signal

◆ sceneGraphInvalidated()

void QQuickImageParticle::sceneGraphInvalidated ( )
overrideprotectedvirtual

Reimplemented from QQuickParticlePainter.

Definition at line 749 of file qquickimageparticle.cpp.

◆ setAlpha

void QQuickImageParticle::setAlpha ( qreal arg)
slot

Definition at line 865 of file qquickimageparticle.cpp.

◆ setAlphaVariation

void QQuickImageParticle::setAlphaVariation ( qreal arg)
slot

Definition at line 855 of file qquickimageparticle.cpp.

◆ setAutoRotation

void QQuickImageParticle::setAutoRotation ( bool arg)
slot

Definition at line 945 of file qquickimageparticle.cpp.

◆ setBlueVariation

void QQuickImageParticle::setBlueVariation ( qreal arg)
slot

Definition at line 895 of file qquickimageparticle.cpp.

◆ setBypassOptimizations

void QQuickImageParticle::setBypassOptimizations ( bool arg)
slot

Definition at line 983 of file qquickimageparticle.cpp.

◆ setColor()

void QQuickImageParticle::setColor ( const QColor & color)

Definition at line 835 of file qquickimageparticle.cpp.

◆ setColortable()

void QQuickImageParticle::setColortable ( const QUrl & table)

Definition at line 778 of file qquickimageparticle.cpp.

◆ setColorVariation()

void QQuickImageParticle::setColorVariation ( qreal var)

Definition at line 845 of file qquickimageparticle.cpp.

◆ setEntryEffect

void QQuickImageParticle::setEntryEffect ( EntryEffect arg)
slot

Definition at line 993 of file qquickimageparticle.cpp.

◆ setGreenVariation

void QQuickImageParticle::setGreenVariation ( qreal arg)
slot

Definition at line 885 of file qquickimageparticle.cpp.

◆ setImage()

void QQuickImageParticle::setImage ( const QUrl & image)

Definition at line 758 of file qquickimageparticle.cpp.

◆ setOpacitytable()

void QQuickImageParticle::setOpacitytable ( const QUrl & table)

Definition at line 816 of file qquickimageparticle.cpp.

◆ setRedVariation

void QQuickImageParticle::setRedVariation ( qreal arg)
slot

Definition at line 875 of file qquickimageparticle.cpp.

◆ setRotation

void QQuickImageParticle::setRotation ( qreal arg)
slot

Definition at line 905 of file qquickimageparticle.cpp.

◆ setRotationVariation

void QQuickImageParticle::setRotationVariation ( qreal arg)
slot

Definition at line 915 of file qquickimageparticle.cpp.

◆ setRotationVelocity

void QQuickImageParticle::setRotationVelocity ( qreal arg)
slot

Definition at line 925 of file qquickimageparticle.cpp.

◆ setRotationVelocityVariation

void QQuickImageParticle::setRotationVelocityVariation ( qreal arg)
slot

Definition at line 935 of file qquickimageparticle.cpp.

◆ setSizetable()

void QQuickImageParticle::setSizetable ( const QUrl & table)

Definition at line 797 of file qquickimageparticle.cpp.

◆ setSpritesInterpolate

void QQuickImageParticle::setSpritesInterpolate ( bool arg)
slot

Definition at line 975 of file qquickimageparticle.cpp.

◆ setXVector

void QQuickImageParticle::setXVector ( QQuickDirection * arg)
slot

Definition at line 955 of file qquickimageparticle.cpp.

◆ setYVector

void QQuickImageParticle::setYVector ( QQuickDirection * arg)
slot

Definition at line 965 of file qquickimageparticle.cpp.

◆ sizetable()

QUrl QQuickImageParticle::sizetable ( ) const
inline

Definition at line 223 of file qquickimageparticle_p.h.

◆ sizetableChanged

void QQuickImageParticle::sizetableChanged ( )
signal

◆ spriteEngine()

QQuickStochasticEngine * QQuickImageParticle::spriteEngine ( )
inline

Definition at line 198 of file qquickimageparticle_p.h.

◆ sprites()

QQmlListProperty< QQuickSprite > QQuickImageParticle::sprites ( )

◆ spritesInterpolate()

bool QQuickImageParticle::spritesInterpolate ( ) const
inline

Definition at line 259 of file qquickimageparticle_p.h.

◆ spritesInterpolateChanged

void QQuickImageParticle::spritesInterpolateChanged ( bool arg)
signal

◆ status()

Status QQuickImageParticle::status ( ) const
inline

Definition at line 265 of file qquickimageparticle_p.h.

◆ statusChanged

void QQuickImageParticle::statusChanged ( Status arg)
signal

◆ updatePaintNode()

QSGNode * QQuickImageParticle::updatePaintNode ( QSGNode * oldNode,
UpdatePaintNodeData * updatePaintNodeData )
overrideprotectedvirtual

Called on the render thread when it is time to sync the state of the item with the scene graph.

The function is called as a result of QQuickItem::update(), if the user has set the QQuickItem::ItemHasContents flag on the item.

The function should return the root of the scene graph subtree for this item. Most implementations will return a single QSGGeometryNode containing the visual representation of this item. oldNode is the node that was returned the last time the function was called. updatePaintNodeData provides a pointer to the QSGTransformNode associated with this QQuickItem.

QSGNode *MyItem::updatePaintNode(QSGNode *node, UpdatePaintNodeData *)
{
QSGSimpleRectNode *n = static_cast<QSGSimpleRectNode *>(node);
if (!n) {
n->setColor(Qt::red);
}
return n;
}
virtual QRectF boundingRect() const
Returns the extents of the item in its own coordinate system: a rectangle from {0,...
\group qtquick-scenegraph-nodes \title Qt Quick Scene Graph Node classes
Definition qsgnode.h:37
The QSGSimpleRectNode class is a convenience class for drawing solid filled rectangles using scenegra...
void setRect(const QRectF &rect)
Sets the rectangle of this rect node to rect.
@ red
Definition qnamespace.h:36
GLfloat n
[4]

The main thread is blocked while this function is executed so it is safe to read values from the QQuickItem instance and other objects in the main thread.

If no call to QQuickItem::updatePaintNode() result in actual scene graph changes, like QSGNode::markDirty() or adding and removing nodes, then the underlying implementation may decide to not render the scene again as the visual outcome is identical.

Warning
It is crucial that graphics operations and interaction with the scene graph happens exclusively on the render thread, primarily during the QQuickItem::updatePaintNode() call. The best rule of thumb is to only use classes with the "QSG" prefix inside the QQuickItem::updatePaintNode() function.
This function is called on the render thread. This means any QObjects or thread local storage that is created will have affinity to the render thread, so apply caution when doing anything other than rendering in this function. Similarly for signals, these will be emitted on the render thread and will thus often be delivered via queued connections.
Note
All classes with QSG prefix should be used solely on the scene graph's rendering thread. See \l {Scene Graph and Rendering} for more information.
See also
QSGMaterial, QSGGeometryNode, QSGGeometry, QSGFlatColorMaterial, QSGTextureMaterial, QSGNode::markDirty(), {Graphics Resource Handling}

Reimplemented from QQuickItem.

Definition at line 1512 of file qquickimageparticle.cpp.

◆ xVector()

QQuickDirection * QQuickImageParticle::xVector ( ) const
inline

Definition at line 255 of file qquickimageparticle_p.h.

◆ xVectorChanged

void QQuickImageParticle::xVectorChanged ( QQuickDirection * arg)
signal

◆ yVector()

QQuickDirection * QQuickImageParticle::yVector ( ) const
inline

Definition at line 257 of file qquickimageparticle_p.h.

◆ yVectorChanged

void QQuickImageParticle::yVectorChanged ( QQuickDirection * arg)
signal

Property Documentation

◆ alpha

qreal QQuickImageParticle::alpha
readwrite

Definition at line 170 of file qquickimageparticle_p.h.

◆ alphaVariation

qreal QQuickImageParticle::alphaVariation
readwrite

Definition at line 171 of file qquickimageparticle_p.h.

◆ autoRotation

bool QQuickImageParticle::autoRotation
readwrite

Definition at line 179 of file qquickimageparticle_p.h.

◆ blueVariation

qreal QQuickImageParticle::blueVariation
readwrite

Definition at line 168 of file qquickimageparticle_p.h.

◆ color

QColor QQuickImageParticle::color
readwrite

Definition at line 163 of file qquickimageparticle_p.h.

◆ colorTable

QUrl QQuickImageParticle::colorTable
readwrite

Definition at line 158 of file qquickimageparticle_p.h.

◆ colorVariation

qreal QQuickImageParticle::colorVariation
readwrite

Definition at line 165 of file qquickimageparticle_p.h.

◆ entryEffect

EntryEffect QQuickImageParticle::entryEffect
readwrite

Definition at line 187 of file qquickimageparticle_p.h.

◆ greenVariation

qreal QQuickImageParticle::greenVariation
readwrite

Definition at line 167 of file qquickimageparticle_p.h.

◆ opacityTable

QUrl QQuickImageParticle::opacityTable
readwrite

Definition at line 160 of file qquickimageparticle_p.h.

◆ redVariation

qreal QQuickImageParticle::redVariation
readwrite

Definition at line 166 of file qquickimageparticle_p.h.

◆ rotation

qreal QQuickImageParticle::rotation
readwrite

Definition at line 173 of file qquickimageparticle_p.h.

◆ rotationVariation

qreal QQuickImageParticle::rotationVariation
readwrite

Definition at line 174 of file qquickimageparticle_p.h.

◆ rotationVelocity

qreal QQuickImageParticle::rotationVelocity
readwrite

Definition at line 175 of file qquickimageparticle_p.h.

◆ rotationVelocityVariation

qreal QQuickImageParticle::rotationVelocityVariation
readwrite

Definition at line 176 of file qquickimageparticle_p.h.

◆ sizeTable

QUrl QQuickImageParticle::sizeTable
readwrite

Definition at line 159 of file qquickimageparticle_p.h.

◆ source

QUrl QQuickImageParticle::source
readwrite

Definition at line 152 of file qquickimageparticle_p.h.

◆ sprites

QQmlListProperty< QQuickSprite > QQuickImageParticle::sprites
read

Definition at line 153 of file qquickimageparticle_p.h.

◆ spritesInterpolate

bool QQuickImageParticle::spritesInterpolate
readwrite

Definition at line 185 of file qquickimageparticle_p.h.

◆ status

Status QQuickImageParticle::status
read

Definition at line 154 of file qquickimageparticle_p.h.

◆ xVector

QQuickDirection* QQuickImageParticle::xVector
readwrite

Definition at line 182 of file qquickimageparticle_p.h.

◆ yVector

QQuickDirection* QQuickImageParticle::yVector
readwrite

Definition at line 184 of file qquickimageparticle_p.h.


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