プロパティ

Defold は、ゲームオブジェクト（game object）、コンポーネント（component）、GUI ノード（GUI node）に対して、読み取り、設定、アニメーションが可能なプロパティ（property）を公開しています。プロパティには次の種類があります。

• システムが定義するゲームオブジェクトのトランスフォーム（transform）（位置、回転、スケール）と、コンポーネント固有のプロパティ（たとえば、スプライト（sprite）のピクセル単位のサイズや、コリジョンオブジェクト（collision object）の質量）
• Lua スクリプトで定義する、スクリプトコンポーネント（script component）のユーザー定義プロパティ（詳細はスクリプトプロパティのドキュメントを参照してください）
• GUI ノードのプロパティ
• シェーダー（shader）とマテリアル（material）ファイルで定義するシェーダー定数（shader constant）（詳細はマテリアルのドキュメントを参照してください）

数値プロパティの入力欄にマウスポインターを合わせると、ドラッグハンドルが表示されます。ハンドルを右または上にドラッグすると値を増やし、左または下にドラッグすると値を減らせます。

プロパティの所在によって、汎用関数またはプロパティ専用の関数を使ってアクセスします。多くのプロパティは自動的にアニメーションさせることができます。パフォーマンスと利便性の両面から、プロパティを自分で（update() 関数内で）操作するよりも、組み込みの仕組みでアニメーションさせることを強く推奨します。

vector3、vector4、quaternion 型の複合プロパティは、その成分（x、y、z、w）も公開しています。プロパティ名の末尾にドット（.）と成分名を付けると、各成分を個別に指定できます。たとえば、ゲームオブジェクトの位置の x 成分を設定するには、次のようにします。

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

go.get()、go.set()、go.animate() 関数は、第1パラメーターに参照、第2パラメーターにプロパティ識別子を受け取ります。参照はゲームオブジェクトまたはコンポーネントを識別するもので、文字列、ハッシュ、URL のいずれかを使えます。URL についてはアドレス指定のマニュアルで詳しく説明しています。プロパティ識別子は、プロパティの名前を表す文字列またはハッシュです。

-- 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 ノードの場合は、プロパティ専用の関数、または汎用の gui.get() および gui.set() 関数の第1パラメーターにノードを渡します。

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

ゲームオブジェクトとコンポーネントのプロパティ

すべてのゲームオブジェクトと一部の種類のコンポーネントには、実行時に読み取りや操作ができるプロパティがあります。これらの値は go.get() で読み取り、go.set() で書き込みます。プロパティの値の型によっては、go.animate() で値をアニメーションさせることができます。読み取り専用のプロパティも少数あります。

get

go.get() で読み取れます。

get+set

go.get() で読み取り、go.set() で書き込めます。数値は go.animate() でアニメーションさせることができます。

ゲームオブジェクトのプロパティ

スプライトコンポーネントのプロパティ

コリジョンオブジェクトコンポーネントのプロパティ

モデル（3D）コンポーネントのプロパティ

ラベルコンポーネントのプロパティ

GUI ノードのプロパティ

GUI ノードには、gui.get_position() や gui.set_position() のような、プロパティ専用の取得関数と設定関数があります。以下に示す組み込みプロパティは、代わりに gui.get(node, property) と gui.set(node, property, value) でも読み書きできます。それ以外のノードの値には、引き続き専用関数が必要な場合があります。GUI ノードのマテリアル定数にも汎用関数を使います。ベクトルプロパティの1つの成分を指定するには、たとえば gui.set(node, "color.x", 1) のように、その成分名を末尾に付けます。

汎用関数とプロパティ専用の関数は、必ずしも同じ値の型を使うわけではありません。gui.get() は position、scale、size、euler プロパティの値全体を vector4 として返しますが、対応するプロパティ専用の関数は vector3 を返します。gui.set() は、これらのプロパティに対して vector3 と vector4 のどちらも受け付けます。汎用関数の rotation プロパティはクォータニオン（quaternion）を使います。回転を度数で設定する場合は euler を使ってください。

• position（または gui.PROP_POSITION）
• rotation（または gui.PROP_ROTATION）
• euler（または gui.PROP_EULER）
• scale（または gui.PROP_SCALE）
• color（または gui.PROP_COLOR）
• outline（または gui.PROP_OUTLINE）
• shadow（または gui.PROP_SHADOW）
• size（または gui.PROP_SIZE）
• fill_angle（または gui.PROP_FILL_ANGLE）
• inner_radius（または gui.PROP_INNER_RADIUS）
• leading（または gui.PROP_LEADING）
• tracking（または gui.PROP_TRACKING）
• slice9（または gui.PROP_SLICE9）

すべての色の値は vector4 に格納され、各成分が次の RGBA 値に対応することに注意してください。

x

赤の色成分

y

緑の色成分

z

青の色成分

w

アルファ成分

GUI ノードのプロパティ