Propiedades

Defold expone propiedades para objetos de juego (Game objects), componentes (Components) y nodos GUI que se pueden leer, definir y animar. Existen los siguientes tipos de propiedades:

• Transformaciones de objetos de juego definidas por el sistema (posición, rotación y escala) y propiedades específicas de componentes (por ejemplo, el tamaño en píxeles de un sprite o la masa de un objeto de colisión)
• Propiedades de componentes de script definidas por el usuario en scripts Lua (consulta la documentación de propiedades de script para más detalles)
• Propiedades de nodos GUI
• Constantes de shader definidas en shaders y archivos de material (consulta la documentación de material para más detalles)

Las propiedades numéricas muestran un control de arrastre cuando pasas el cursor sobre su campo de entrada. Puedes aumentar o disminuir su valor arrastrando el control hacia la derecha/izquierda o arriba/abajo, respectivamente.

Según dónde se encuentre una propiedad, accedes a ella mediante una función genérica o una función específica de la propiedad. Muchas de las propiedades se pueden animar automáticamente. Se recomienda encarecidamente animar propiedades mediante el sistema integrado en vez de manipularlas directamente (dentro de una función update()), tanto por rendimiento como por comodidad.

Las propiedades compuestas de tipo vector3, vector4 o quaternion también exponen sus subcomponentes (x, y, z y w). Puedes hacer referencia a los componentes individualmente añadiendo al nombre un punto (.) y el nombre del componente. Por ejemplo, para definir el componente x de la posición de un objeto de juego:

-- Define la posición x de "game_object" en 10.
go.set("game_object", "position.x", 10)

Las funciones go.get(), go.set() y go.animate() toman una referencia como primer parámetro y un identificador de propiedad como segundo. La referencia identifica el objeto de juego o componente, y puede ser un string, un hash o una URL. Las URL se explican en detalle en el manual de direccionamiento. El identificador de propiedad es un string o hash que nombra la propiedad:

-- Define la escala x del componente sprite
local url = msg.url("#sprite")
local prop = hash("scale.x")
go.set(url, prop, 2.0)

En los nodos GUI, el nodo se proporciona como primer parámetro a una función específica de la propiedad o a las funciones genéricas gui.get() y gui.set():

-- Obtiene el color del botón
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)

Propiedades de objetos de juego y componentes

Todos los objetos de juego, y algunos tipos de componente, tienen propiedades que se pueden leer y manipular en tiempo de ejecución. Obtén estos valores con go.get() y defínelos con go.set(). Según el tipo del valor de la propiedad, puedes animar los valores con go.animate(). Un pequeño conjunto de propiedades es de solo lectura.

get

Se puede leer con go.get().

get+set

Se puede leer con go.get() y escribir con go.set(). Los valores numéricos se pueden animar con go.animate().

PROPIEDADES DE OBJETOS DE JUEGO

PROPIEDADES DEL COMPONENTE SPRITE

PROPIEDADES DEL COMPONENTE COLLISION OBJECT

PROPIEDADES DEL COMPONENTE MODEL (3D)

PROPIEDADES DEL COMPONENTE LABEL

Propiedades de nodos GUI

Los nodos GUI tienen funciones getter y setter específicas de cada propiedad, como gui.get_position() y gui.set_position(). Como alternativa, las propiedades integradas que se indican a continuación pueden leerse y escribirse con gui.get(node, property) y gui.set(node, property, value). Otros valores de nodo pueden seguir requiriendo sus funciones específicas. Las constantes de material de los nodos GUI también usan las funciones genéricas. Para direccionar un componente de una propiedad vectorial, agrega su nombre; por ejemplo, gui.set(node, "color.x", 1).

Las funciones genéricas y las específicas de cada propiedad no siempre usan tipos de valor idénticos. gui.get() devuelve un vector4 para las propiedades completas position, scale, size y euler, mientras que las funciones específicas correspondientes devuelven un vector3. gui.set() acepta un vector3 o un vector4 para esas propiedades. La propiedad genérica rotation usa un quaternion; usa euler al definir la rotación en grados.

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

Ten en cuenta que todos los valores de color están codificados en un vector4, donde los componentes corresponden a los valores RGBA:

x

El componente de color rojo

y

El componente de color verde

z

El componente de color azul

w

El componente alfa

PROPIEDADES DE NODOS GUI