Sprite QML Type
Gibt Sprite-Animationen an. Mehr...
| Import Statement: | import QtQuick |
Eigenschaften
- duration : int
- durationVariation : int
- frameCount : int
- frameDuration : int
- frameDurationVariation : int
- frameHeight : int
- frameRate : real
- frameRateVariation : real
- frameSync : bool
- frameWidth : int
- frameX : int
- frameY : int
- name : string
- randomStart : bool
- reverse : bool
- source : url
- to : QVariantMap
Detaillierte Beschreibung
Sprite definiert eine Reihe von einem oder mehreren Bildern, die von SpriteSequence animiert und gerendert werden. Die Sprites können sich in der Mitte einer Bilddatei befinden oder auf mehrere Zeilen aufgeteilt sein, solange sie eine zusammenhängende Zeile bilden, die vom linken Rand der Datei bis zur nächsten Zeile der Datei reicht.
Weitere Einzelheiten finden Sie in der Übersicht über Sprite-Animationen.
Dokumentation der Eigenschaft
duration : int
Dauer der Animation. Werte unter 0 sind ungültig.
Wenn frameRate gültig ist, wird es für die Berechnung der Dauer der Bilder verwendet. Falls nicht und frameDuration gültig ist, wird frameDuration verwendet. Andernfalls wird duration verwendet.
durationVariation : int
Die Dauer der Animation kann bis zu diesem Wert variieren. Variation wird die Länge der Animation nie auf weniger als 0 verringern.
durationVariation wird nur dann wirksam, wenn duration zur Berechnung der Dauer der Bilder verwendet wird.
Die Voreinstellung ist 0.
frameCount : int
Anzahl der Frames in diesem Sprite.
frameDuration : int
Dauer der einzelnen Bilder der Animation in Millisekunden. Werte unter 0 sind ungültig.
Wenn frameRate gültig ist, wird es zur Berechnung der Dauer der Bilder verwendet. Falls nicht und frameDuration gültig ist, wird frameDuration verwendet. Andernfalls wird duration verwendet.
frameDurationVariation : int
Die Dauer eines Bildes in der Animation kann bis zu diesem Wert variieren. Variation wird die Länge der Animation nie auf weniger als 0 verringern.
frameDurationVariation wird nur wirksam, wenn frameDuration für die Berechnung der Dauer von Frames verwendet wird.
Die Voreinstellung ist 0.
frameHeight : int
Höhe eines Einzelbildes in diesem Sprite.
frameRate : real
Bilder pro Sekunde, die in der Animation angezeigt werden sollen. Werte unter 0 sind ungültig.
Wenn frameRate gültig ist, wird es verwendet, um die Dauer der Bilder zu berechnen. Falls nicht und frameDuration gültig ist, wird frameDuration verwendet. Andernfalls wird duration verwendet.
frameRateVariation : real
Die Bildrate zwischen den Animationen kann bis zu diesem Wert variieren. Variation wird die Länge der Animation nie auf weniger als 0 verringern.
frameRateVariation wird nur wirksam, wenn frameRate zur Berechnung der Dauer der Frames verwendet wird.
Die Voreinstellung ist 0.
frameSync : bool
Wenn true, hat die Animation keine Dauer. Stattdessen wird die Animation jedes Mal um ein Bild weitergeschaltet, wenn ein Bild auf dem Bildschirm gerendert wird. Dadurch wird sie mit der Bildrate synchronisiert und nicht mit der verstrichenen Zeit.
Wenn frameSync auf true gesetzt ist, hat es Vorrang vor duration, frameRate und frameDuration.
Die Voreinstellung ist false.
frameWidth : int
Breite eines Einzelbildes in diesem Sprite.
frameX : int
Die X-Koordinate in der Bilddatei des ersten Bildes des Sprites.
frameY : int
Die Y-Koordinate in der Bilddatei des ersten Bildes des Sprites.
name : string
Der Name dieses Sprites, zur Verwendung in der Eigenschaft to anderer Sprites.
randomStart : bool
Bei "true" beginnt die Animation mit der ersten Animation, wobei ein zufälliger Teil der Dauer übersprungen wird. Dadurch sehen die Animationen nicht so aus, als hätten sie gerade erst begonnen, wenn die Animation beginnt.
Dies betrifft nur die allererste Animation, die abgespielt wird. Der Übergang zu einer anderen Animation oder die Wiederholung derselben Animation löst dies nicht aus.
Die Voreinstellung ist false.
reverse : bool
Wenn true, dann wird die Animation rückwärts abgespielt.
Die Voreinstellung ist false.
source : url
Die Bildquelle für die Animation.
Wenn frameHeight und frameWidth nicht angegeben sind, wird davon ausgegangen, dass es sich um eine einzelne lange Reihe von quadratischen Bildern handelt. Andernfalls kann es sich um mehrere zusammenhängende Reihen oder rechteckige Frames handeln; wenn eine Reihe zu Ende geht, wird die nächste verwendet.
Wenn frameX und frameY angegeben sind, wird die Reihe von Rahmen mit dieser x/y-Koordinate als obere linke Ecke genommen.
to : QVariantMap
Eine Liste anderer Sprites und gewichteter Übergänge zu ihnen, z. B. {"a":1, "b":2, "c":0} würde festlegen, dass ein Drittel zu Sprite "a" übergehen soll, wenn dieses Sprite fertig ist, und zwei Drittel zu Sprite "b", wenn dieses Sprite fertig ist. Da die Übergänge zufällig gewählt werden, sind diese Proportionen nicht exakt. Mit "c":0 in der Liste wird kein Sprite zufällig zu "c" übergehen, aber es wird ein gültiger Pfad sein, wenn ein Sprite-Ziel gesetzt ist.
Wenn keine Liste angegeben wird oder die Summe der Gewichte in der Liste gleich Null ist, wiederholt sich das Sprite nach der Fertigstellung.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
