Propriedades

O Defold expõe propriedades para objetos de jogo, componentes e nodes de GUI que podem ser lidas, definidas e animadas. Existem os seguintes tipos de propriedades:

• Transformações de objeto de jogo definidas pelo sistema (posição, rotação e escala) e propriedades específicas de componentes (por exemplo, o tamanho em pixels de um sprite ou a massa de um objeto de colisão)
• Propriedades de componentes de script definidas pelo usuário em scripts Lua (veja a documentação de propriedades de script para detalhes)
• Propriedades de nodes de GUI
• Constantes de shader definidas em shaders e arquivos de material (veja a documentação de Material para detalhes)

Propriedades numéricas exibem uma alça de arrasto quando você passa o mouse sobre o campo de entrada. Você pode aumentar/diminuir o valor arrastando a alça para a direita/esquerda ou para cima/baixo, respectivamente.

Dependendo de onde uma propriedade é encontrada, você a acessa por meio de uma função genérica ou de uma função específica da propriedade. Muitas propriedades podem ser animadas automaticamente. Animar propriedades pelo sistema integrado é altamente recomendado em vez de manipular as propriedades você mesmo (dentro de uma função update()), tanto por motivos de desempenho quanto de conveniência.

Propriedades compostas dos tipos vector3, vector4 ou quaternion também expõem seus subcomponentes (x, y, z e w). Você pode endereçar os componentes individualmente adicionando um ponto (.) e o nome do componente ao nome da propriedade. Por exemplo, para definir o componente x da posição de um objeto de jogo:

-- Define a posição x de "game_object" para 10.
go.set("game_object", "position.x", 10)

As funções go.get(), go.set() e go.animate() recebem uma referência como primeiro parâmetro e um identificador de propriedade como segundo. A referência identifica o objeto de jogo ou componente e pode ser uma string, um hash ou uma URL. URLs são explicadas em detalhe no manual de endereçamento. O identificador de propriedade é uma string ou hash que nomeia a propriedade:

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

Para nodes de GUI, o node é fornecido como primeiro parâmetro de uma função específica da propriedade ou das funções genéricas gui.get() e gui.set():

-- Obtém a cor do botão
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)

Propriedades de objetos de jogo e componentes

Todos os objetos de jogo, e alguns tipos de componente, têm propriedades que podem ser lidas e manipuladas em tempo de execução. Leia esses valores com go.get() e escreva-os com go.set(). Dependendo do tipo de valor da propriedade, você pode animar os valores com go.animate(). Um pequeno conjunto de propriedades é somente leitura.

get

Pode ser lida com go.get().

get+set

Pode ser lida com go.get() e escrita com go.set(). Valores numéricos podem ser animados com go.animate().

PROPRIEDADES DE OBJETO DE JOGO

PROPRIEDADES DE COMPONENTE SPRITE

PROPRIEDADES DE COMPONENTE DE OBJETO DE COLISÃO

PROPRIEDADES DE COMPONENTE MODEL (3D)

PROPRIEDADES DE COMPONENTE LABEL

Propriedades de nodes de GUI

Nodes de GUI têm funções getter e setter específicas para cada propriedade, como gui.get_position() e gui.set_position(). Como alternativa, as propriedades integradas listadas abaixo podem ser lidas e escritas com gui.get(node, property) e gui.set(node, property, value). Outros valores de node ainda podem exigir suas funções dedicadas. Constantes de material em nodes de GUI também usam as funções genéricas. Para endereçar um componente de uma propriedade vetorial, acrescente seu nome, por exemplo gui.set(node, "color.x", 1).

As funções genéricas e as funções específicas da propriedade nem sempre usam tipos de valor idênticos. gui.get() retorna um vector4 para as propriedades completas position, scale, size e euler, enquanto as funções específicas correspondentes retornam um vector3. gui.set() aceita um vector3 ou vector4 para essas propriedades. A propriedade genérica rotation usa um quaternion; use euler ao definir a rotação em graus.

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

Observe que todos os valores de cor são codificados em um vector4, onde os componentes correspondem aos valores RGBA:

x

O componente de cor vermelho

y

O componente de cor verde

z

O componente de cor azul

w

O componente alfa

PROPRIEDADES DE NODE DE GUI