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.
Eigenschaft Dokumentation
duration : int |
Dauer der Animation. Werte unter 0 sind ungültig.
Wenn frameRate gültig ist, wird es verwendet, um die Dauer der Frames zu berechnen. 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 niemals auf weniger als 0 verringern.
durationVariation wird nur wirksam, wenn duration für die Berechnung der Dauer der Bilder verwendet wird.
Voreinstellung ist 0.
frameCount : int |
Anzahl der Frames in diesem Sprite.
frameDuration : int |
Dauer der einzelnen Frames der Animation in Millisekunden. Werte unter 0 sind ungültig.
Wenn frameRate gültig ist, wird es zur Berechnung der Dauer der Frames 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 niemals 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 |
Frames 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 Frames 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 niemals 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, dann 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 Frames 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 to-Eigenschaft anderer Sprites.
randomStart : bool |
Wenn true, dann wird die erste Animation mit einem zufälligen Teil der Dauer übersprungen. 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 angenommen, 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 Frames 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, dann wiederholt sich das Sprite nach der Fertigstellung.
© 2025 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.
