Sprite QML Type

Legt Sprite-Animationen fest. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

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

Ausführliche Beschreibung

Ein Sprite definiert eine Reihe von einem oder mehreren Frames, die von SpriteSequence animiert und gerendert werden sollen. Die Sprites können sich in der Mitte einer Bilddatei befinden oder über mehrere Zeilen verteilt sein, solange sie eine zusammenhängende Zeile bilden, die vom linken Rand der Datei aus in die nächste Zeile der Datei übergeht.

Ausführliche Informationen finden Sie in der Übersicht zu Sprite-Animationen.

Dokumentation zu den Eigenschaften

duration : int

Dauer der Animation. Werte unter 0 sind ungültig.

Ist „ frameRate “ gültig, wird dieser Wert zur Berechnung der Dauer der Einzelbilder herangezogen. Ist dies nicht der Fall und ist „ frameDuration “ gültig, wird „ frameDuration “ verwendet. Andernfalls wird „duration“ verwendet.

durationVariation : int

Die Dauer der Animation kann um diesen Wert variieren. Durch die Variation wird die Dauer der Animation niemals auf weniger als 0 verringert.

„durationVariation“ wirkt sich nur aus, wenn „duration“ zur Berechnung der Dauer der Einzelbilder verwendet wird.

Der Standardwert ist 0.

frameCount : int

Anzahl der Frames in diesem Sprite.

frameDuration : int

Dauer jedes Einzelbildes der Animation in Millisekunden. Werte unter 0 sind ungültig.

Ist „ frameRate “ gültig, wird dieser Wert zur Berechnung der Dauer der Einzelbilder herangezogen. Ist dies nicht der Fall und ist „frameDuration“ gültig, wird „frameDuration“ verwendet. Andernfalls wird „duration“ verwendet.

frameDurationVariation : int

Die Dauer eines Frames in der Animation kann um bis zu diesen Wert variieren. Durch die Variation wird die Länge der Animation niemals auf weniger als 0 verringert.

„frameDurationVariation“ wirkt sich nur aus, wenn zur Berechnung der Bilddauer die Option „ frameDuration “ verwendet wird.

Der Standardwert ist 0.

frameHeight : int

Höhe eines einzelnen Frames in diesem Sprite.

frameRate : real

Anzahl der Bilder pro Sekunde, die in der Animation angezeigt werden sollen. Werte unter 0 sind ungültig.

Ist „frameRate“ gültig, wird dieser Wert zur Berechnung der Dauer der Einzelbilder herangezogen. Ist dies nicht der Fall und ist „ frameDuration “ gültig, wird „ frameDuration “ verwendet. Andernfalls wird „duration“ verwendet.

frameRateVariation : real

Die Bildrate zwischen den Animationen kann um bis zu diesen Wert variieren. Durch diese Schwankung wird die Dauer der Animation niemals auf weniger als 0 verkürzt.

„frameRateVariation“ wirkt sich nur aus, wenn „ frameRate “ zur Berechnung der Dauer der Einzelbilder verwendet wird.

Der Standardwert ist 0.

frameSync : bool

Ist dieser Wert auf „true“ gesetzt, hat die Animation keine Dauer. Stattdessen wird die Animation jedes Mal um ein Einzelbild weitergeschaltet, wenn ein Einzelbild auf dem Bildschirm gerendert wird. Dadurch wird sie mit der Bildwiederholrate synchronisiert und nicht mit der verstrichenen Zeit.

Wenn „frameSync“ auf „true“ gesetzt ist, überschreibt dies alle Einstellungen für „duration“, „ frameRate “ und „ frameDuration “.

Der Standardwert ist „false“.

frameWidth : int

Breite eines einzelnen Frames 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 Frames des Sprites.

name : string

Der Name dieses Sprites, zur Verwendung in der „to“-Eigenschaft anderer Sprites.

randomStart : bool

Wenn diese Option aktiviert ist, wird bei der ersten Animation ein zufälliger Teil ihrer Dauer übersprungen. Dadurch sieht es nicht so aus, als hätten alle Animationen gerade erst begonnen, wenn die Animation startet.

Dies betrifft nur die allererste abgespielte Animation. Der Übergang zu einer anderen Animation oder zur gleichen Animation erneut löst dies nicht aus.

Der Standardwert ist „false“.

reverse : bool

Wenn „true“, wird die Animation rückwärts abgespielt.

Der Standardwert 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 einzige lange Reihe quadratischer Frames handelt. Andernfalls kann es sich um mehrere zusammenhängende Reihen oder rechteckige Frames handeln; wenn eine Reihe zu Ende ist, wird die nächste verwendet.

Wenn frameX und frameY angegeben sind, wird die Rahmenreihe mit diesen x/y-Koordinaten als linker oberer Eckpunkt verwendet.

to : QVariantMap

Eine Liste weiterer Sprites und der entsprechenden gewichteten Übergänge, zum Beispiel {"a":1, "b":2, "c":0} würde festlegen, dass ein Drittel zum Sprite „a“ übergehen soll, wenn dieses Sprite beendet ist, und zwei Drittel zum Sprite „b“ übergehen sollen, wenn dieses Sprite beendet ist. Da die Übergänge zufällig ausgewählt werden, stimmen diese Anteile nicht exakt überein. Wenn „c“:0 in der Liste enthalten ist, wird kein Sprite zufällig zu „c“ übergehen, aber es ist ein gültiger Pfad, wenn ein Sprite-Ziel festgelegt ist.

Wenn keine Liste angegeben ist oder die Summe der Gewichte in der Liste null beträgt, wiederholt sich das Sprite nach seiner Ausführung.