Proprietà

Defold espone proprietà per oggetti di gioco (game object), componenti e nodi GUI che puoi leggere, impostare e animare. Esistono i seguenti tipi di proprietà:

• Trasformazioni degli oggetti di gioco definite dal sistema (posizione, rotazione e scala) e proprietà specifiche dei componenti (per esempio le dimensioni in pixel di uno sprite o la massa di un oggetto di collisione)
• Proprietà dei componenti script definite dall’utente negli script Lua (consulta la documentazione sulle proprietà degli script per i dettagli)
• Proprietà dei nodi GUI
• Costanti degli shader definite negli shader e nei file dei materiali (consulta la documentazione sui materiali per i dettagli)

Le proprietà numeriche mostrano una maniglia di trascinamento quando passi il puntatore sul loro campo di immissione. Puoi aumentare o diminuire il valore trascinando la maniglia rispettivamente verso destra o sinistra, oppure verso l’alto o il basso.

A seconda di dove si trova una proprietà, puoi accedervi tramite una funzione generica o una funzione specifica per quella proprietà. Molte proprietà possono essere animate automaticamente. È fortemente consigliato animare le proprietà tramite il sistema integrato anziché modificarle direttamente (all’interno di una funzione update()), sia per le prestazioni sia per la praticità.

Le proprietà composte di tipo vector3, vector4 o quaternion espongono anche le proprie componenti (x, y, z e w). Puoi accedere alle componenti singolarmente aggiungendo al nome della proprietà un punto (.) e il nome della componente. Per esempio, per impostare la componente x della posizione di un oggetto di gioco:

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

Le funzioni go.get(), go.set() e go.animate() accettano un riferimento come primo parametro e un identificatore di proprietà come secondo. Il riferimento identifica l’oggetto di gioco o il componente e può essere una stringa, un hash o un URL. Gli URL sono spiegati in dettaglio nel manuale sull’indirizzamento. L’identificatore della proprietà è una stringa o un hash che ne specifica il nome:

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

Per i nodi GUI, il nodo viene passato come primo parametro a una funzione specifica per la proprietà oppure alle funzioni generiche gui.get() e gui.set():

-- 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)

Proprietà degli oggetti di gioco e dei componenti

Tutti gli oggetti di gioco e alcuni tipi di componenti hanno proprietà che puoi leggere e modificare durante l’esecuzione. Leggi questi valori con go.get() e scrivili con go.set(). A seconda del tipo di valore della proprietà, puoi animarne i valori con go.animate(). Un piccolo gruppo di proprietà è di sola lettura.

get

Puoi leggerla con go.get().

get+set

Puoi leggerla con go.get() e scriverla con go.set(). Puoi animare i valori numerici con go.animate().

PROPRIETÀ DEGLI OGGETTI DI GIOCO

PROPRIETÀ DEL COMPONENTE SPRITE

PROPRIETÀ DEL COMPONENTE OGGETTO DI COLLISIONE

PROPRIETÀ DEL COMPONENTE MODELLO (3D)

PROPRIETÀ DEL COMPONENTE ETICHETTA (LABEL)

Proprietà dei nodi GUI

I nodi GUI hanno funzioni di lettura e scrittura specifiche per ciascuna proprietà, come gui.get_position() e gui.set_position(). In alternativa, puoi leggere e scrivere le proprietà integrate elencate di seguito con gui.get(node, property) e gui.set(node, property, value). Altri valori dei nodi possono comunque richiedere le rispettive funzioni dedicate. Anche le costanti dei materiali sui nodi GUI usano le funzioni generiche. Per accedere a una componente di una proprietà vettoriale, aggiungine il nome, per esempio gui.set(node, "color.x", 1).

Le funzioni generiche e quelle specifiche per le proprietà non usano sempre gli stessi tipi di valore. gui.get() restituisce un vector4 per le proprietà complete position, scale, size ed euler, mentre le funzioni specifiche corrispondenti restituiscono un vector3. gui.set() accetta sia un vector3 sia un vector4 per queste proprietà. La proprietà generica rotation usa un quaternione; usa euler per impostare la rotazione in gradi.

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

Tutti i valori dei colori sono codificati in un vector4 le cui componenti corrispondono ai valori RGBA:

x

La componente rossa del colore

y

La componente verde del colore

z

La componente blu del colore

w

La componente alfa

PROPRIETÀ DEI NODI GUI