Eigenschaften

Defold stellt Eigenschaften (properties) für Spielobjekte (game objects), Komponenten (components) und GUI-Knoten (GUI nodes) bereit, die gelesen, gesetzt und animiert werden können. Es gibt die folgenden Arten von Eigenschaften:

• Systemdefinierte Transformationen von Spielobjekten (Position, Drehung und Skalierung) und komponentenspezifische Eigenschaften (zum Beispiel die Größe eines Sprites in Pixeln oder die Masse eines Kollisionsobjekts (collision object))
• Benutzerdefinierte Eigenschaften von Skriptkomponenten, die in Lua-Skripten definiert werden (Einzelheiten findest du in der Dokumentation zu Skripteigenschaften)
• Eigenschaften von GUI-Knoten
• Shader-Konstanten, die in Shadern und Materialdateien definiert werden (Einzelheiten findest du in der Dokumentation zu Materialien)

Numerische Eigenschaften zeigen einen Ziehgriff an, wenn du den Mauszeiger über ihr Eingabefeld bewegst. Du kannst ihren Wert erhöhen oder verringern, indem du den Griff nach rechts oder links beziehungsweise nach oben oder unten ziehst.

Je nachdem, wo eine Eigenschaft vorkommt, greifst du über eine allgemeine Funktion oder eine eigenschaftsspezifische Funktion auf sie zu. Viele Eigenschaften können automatisch animiert werden. Es wird dringend empfohlen, Eigenschaften über das integrierte System zu animieren, statt sie selbst (innerhalb einer update()-Funktion) zu verändern. Das ist sowohl aus Leistungsgründen als auch wegen der bequemeren Handhabung sinnvoll.

Zusammengesetzte Eigenschaften vom Typ vector3, vector4 oder quaternion stellen auch ihre Teilkomponenten (x, y, z und w) bereit. Du kannst die Teilkomponenten einzeln ansprechen, indem du an den Namen einen Punkt (.) und den Namen der Teilkomponente anhängst. So setzt du zum Beispiel die x-Komponente der Position eines Spielobjekts:

-- Set the x position of "game_object" to 10.
go.set("game_object", "position.x", 10)

Die Funktionen go.get(), go.set() und go.animate() nehmen als ersten Parameter eine Referenz und als zweiten einen Eigenschaftsbezeichner entgegen. Die Referenz bezeichnet das Spielobjekt oder die Komponente und kann eine Zeichenfolge, ein Hashwert oder eine URL sein. URLs werden im Handbuch zur Adressierung ausführlich erklärt. Der Eigenschaftsbezeichner ist eine Zeichenfolge oder ein Hashwert, der die Eigenschaft benennt:

-- Set the x-scale of the sprite component
local url = msg.url("#sprite")
local prop = hash("scale.x")
go.set(url, prop, 2.0)

Bei GUI-Knoten wird der Knoten als erster Parameter an eine eigenschaftsspezifische Funktion oder an die allgemeinen Funktionen gui.get() und gui.set() übergeben:

-- Get the color of the button
local node = gui.get_node("button")
local color = gui.get_color(node)
local same_color = gui.get(node, "color")
gui.set(node, "color.x", 1)

Eigenschaften von Spielobjekten und Komponenten

Alle Spielobjekte und einige Komponententypen haben Eigenschaften, die zur Laufzeit gelesen und verändert werden können. Lies diese Werte mit go.get() und schreibe sie mit go.set(). Je nach Datentyp des Eigenschaftswerts kannst du die Werte mit go.animate() animieren. Ein kleiner Teil der Eigenschaften kann nur gelesen werden.

get

Kann mit go.get() gelesen werden.

get+set

Kann mit go.get() gelesen und mit go.set() geschrieben werden. Numerische Werte können mit go.animate() animiert werden.

Eigenschaften von Spielobjekten

Eigenschaften von Sprite-Komponenten

Eigenschaften von Kollisionsobjekt-Komponenten

Eigenschaften von Modellkomponenten (3D)

Eigenschaften von Beschriftungskomponenten

Eigenschaften von GUI-Knoten

GUI-Knoten haben eigenschaftsspezifische Getter- und Setter-Funktionen wie gui.get_position() und gui.set_position(). Die unten aufgeführten integrierten Eigenschaften können alternativ mit gui.get(node, property) und gui.set(node, property, value) gelesen und geschrieben werden. Andere Knotenwerte benötigen möglicherweise weiterhin ihre eigenen Funktionen. Materialkonstanten von GUI-Knoten verwenden ebenfalls die allgemeinen Funktionen. Um eine Komponente einer Vektoreigenschaft anzusprechen, hänge ihren Namen an, zum Beispiel gui.set(node, "color.x", 1).

Die allgemeinen und die eigenschaftsspezifischen Funktionen verwenden nicht immer dieselben Datentypen. gui.get() gibt einen vector4 für die vollständigen Eigenschaften position, scale, size und euler zurück, während die entsprechenden eigenschaftsspezifischen Funktionen einen vector3 zurückgeben. gui.set() akzeptiert für diese Eigenschaften sowohl einen vector3 als auch einen vector4. Die allgemeine Eigenschaft rotation verwendet ein Quaternion; verwende euler, wenn du die Drehung in Grad setzt.

• position (oder gui.PROP_POSITION)
• rotation (oder gui.PROP_ROTATION)
• euler (oder gui.PROP_EULER)
• scale (oder gui.PROP_SCALE)
• color (oder gui.PROP_COLOR)
• outline (oder gui.PROP_OUTLINE)
• shadow (oder gui.PROP_SHADOW)
• size (oder gui.PROP_SIZE)
• fill_angle (oder gui.PROP_FILL_ANGLE)
• inner_radius (oder gui.PROP_INNER_RADIUS)
• leading (oder gui.PROP_LEADING)
• tracking (oder gui.PROP_TRACKING)
• slice9 (oder gui.PROP_SLICE9)

Beachte, dass alle Farbwerte in einem vector4 kodiert sind, dessen Komponenten den RGBA-Werten entsprechen:

x

Der rote Farbanteil

y

Der grüne Farbanteil

z

Der blaue Farbanteil

w

Der Alpha-Anteil

Eigenschaften von GUI-Knoten