Özellikler

Defold, oyun nesneleri (game object), bileşenler (component) ve GUI düğümleri (GUI node) için okunabilen, ayarlanabilen ve animasyon uygulanabilen özellikler (property) sunar. Aşağıdaki özellik türleri bulunur:

• Sistem tarafından tanımlanan oyun nesnesi dönüşümleri (konum, dönme ve ölçek) ve bileşene özgü özellikler (örneğin bir sprite bileşeninin piksel boyutu veya bir çarpışma nesnesinin (collision object) kütlesi)
• Lua betiklerinde tanımlanan, kullanıcı tanımlı betik bileşeni (script component) özellikleri (ayrıntılar için Betik özellikleri belgelerine bakın)
• GUI düğümü özellikleri
• Gölgelendiricilerde (shader) ve materyal (material) dosyalarında tanımlanan gölgelendirici sabitleri (ayrıntılar için Materyal belgelerine bakın)

Sayısal özelliklerin giriş alanının üzerine geldiğinizde bir sürükleme tutamacı görünür. Tutamacı sağa/sola veya yukarı/aşağı sürükleyerek değeri sırasıyla artırabilir/azaltabilirsiniz.

Bir özelliğe, bulunduğu yere bağlı olarak genel amaçlı bir işlev veya özelliğe özgü bir işlev aracılığıyla erişirsiniz. Özelliklerin birçoğuna otomatik olarak animasyon uygulanabilir. Hem performans hem de kullanım kolaylığı açısından, özellikleri kendiniz değiştirmek (bir update() işlevinin içinde) yerine yerleşik sistem aracılığıyla animasyon uygulamanız özellikle önerilir.

vector3, vector4 veya kuaterniyon (quaternion) türündeki bileşik özellikler, alt bileşenlerini (x, y, z ve w) de erişime açar. Adın sonuna bir nokta (.) ve bileşenin adını ekleyerek bileşenleri ayrı ayrı adresleyebilirsiniz. Örneğin, bir oyun nesnesinin konumunun x bileşenini ayarlamak için:

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

go.get(), go.set() ve go.animate() işlevleri ilk parametre olarak bir başvuru, ikinci parametre olarak bir özellik tanımlayıcısı alır. Başvuru, oyun nesnesini veya bileşeni tanımlar ve bir dize, karma (hash) değeri veya URL olabilir. URL’ler adresleme kılavuzunda ayrıntılı olarak açıklanır. Özellik tanımlayıcısı, özelliği adlandıran bir dize veya karma değeridir:

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

GUI düğümleri için düğüm, özelliğe özgü bir işleve veya genel amaçlı gui.get() ve gui.set() işlevlerine ilk parametre olarak verilir:

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

Oyun nesnesi ve bileşen özellikleri

Tüm oyun nesneleri ve bazı bileşen türleri, çalışma sırasında okunabilen ve değiştirilebilen özelliklere sahiptir. Bu değerleri go.get() ile okuyun ve go.set() ile yazın. Özellik değerinin türüne bağlı olarak, değerlere go.animate() ile animasyon uygulayabilirsiniz. Özelliklerin küçük bir bölümü salt okunurdur.

get

go.get() ile okunabilir.

get+set

go.get() ile okunabilir ve go.set() ile yazılabilir. Sayısal değerlere go.animate() ile animasyon uygulanabilir.

Oyun nesnesi özellikleri

Sprite bileşeni özellikleri

Çarpışma nesnesi bileşeni özellikleri

Model (3B) bileşeni özellikleri

Etiket bileşeni özellikleri

GUI düğümü özellikleri

GUI düğümlerinin gui.get_position() ve gui.set_position() gibi, özellik değerlerini okumaya ve ayarlamaya özgü işlevleri vardır. Aşağıda listelenen yerleşik özellikler, alternatif olarak gui.get(node, property) ve gui.set(node, property, value) ile de okunup yazılabilir. Diğer düğüm değerleri yine de kendilerine özgü işlevleri gerektirebilir. GUI düğümlerindeki materyal sabitleri de genel amaçlı işlevleri kullanır. Bir vektör özelliğinin tek bir bileşenini adreslemek için sonuna bileşen adını ekleyin; örneğin gui.set(node, "color.x", 1).

Genel amaçlı ve özelliğe özgü işlevler her zaman aynı değer türlerini kullanmaz. gui.get() işleviyle position, scale, size ve euler özellikleri bütün olarak okunduğunda bir vector4 döndürülür; karşılık gelen özelliğe özgü işlevler ise bir vector3 döndürür. gui.set() bu özellikler için hem vector3 hem de vector4 kabul eder. Genel amaçlı rotation özelliği bir kuaterniyon kullanır; dönmeyi derece cinsinden ayarlarken euler kullanın.

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

Tüm renk değerlerinin, bileşenleri RGBA değerlerine karşılık gelen bir vector4 içinde kodlandığını unutmayın:

x

Kırmızı renk bileşeni

y

Yeşil renk bileşeni

z

Mavi renk bileşeni

w

Alfa bileşeni

GUI düğümü özellikleri