本文へスキップ

シャドウマテリアル

説明​

このコンポーネントは、ジオメトリを持つエンティティに影のみをレンダリングするマテリアルを作成します。

プロパティ​

プロパティタイプデフォルト説明
r番号0素材の赤チャンネルの値 [0...255]
g番号0素材のグリーン・チャンネル値 [0...255]
b番号0素材の青チャンネル値 [0...255]
不透明性番号0素材の全体的なアルファ値／透明度 [0...1]
サイドストリングフロント面のどの面をレンダリングするか。 フロント、バック、ダブルからお選びください。
デプス試験ブーリアン真のこの素材をレンダリングする際に深さをテストするかどうか
デプスライトブーリアン真のこの素材のレンダリングが深度バッファに影響を与えるかどうか

機能​

Get​

Returns a read-only reference.

Example

ecs.ShadowMaterial.get(world, component.eid)

Set​

Ensures the component exists on the entity, then assigns the (optional) data to the component.

Example

ecs.ShadowMaterial.set(world, component.eid, {
  r: 0,
  g: 0,
  b: 0,
  opacity: 0.5
})

Mutate​

Perform an update to the component within a callback function. Return true to indicate no changes made.

Example

ecs.ShadowMaterial.mutate(world, component.eid, (cursor) => {
  カーソル.opacity = 0.5;
  カーソル.r = 128;
  カーソル.g = 128;
  カーソル.b = 128;
  return false;
})

Remove​

Removes the component from the entity.

Example

ecs.ShadowMaterial.remove(world, component.eid)

Has​

Returns true if the component is present on the entity.

Example

ecs.ShadowMaterial.has(world, component.eid)

Reset​

Adds, or resets the component to its default state.

Example

ecs.ShadowMaterial.reset(world, component.eid)

Advanced Functions​

Cursor​

Returns a mutable reference. Cursors are reused so only one cursor for each component can exist at a time.

Example
ecs.ShadowMaterial.cursor(world, component.eid)

Acquire​

Same behavior as cursor, but commit must be called after the cursor is done being used.

Example
ecs.ShadowMaterial.acquire(world, component.eid)

Commit​

Called after acquire. An optional third argument determines whether the cursor was mutated or not.

Example
ecs.ShadowMaterial.commit(world, component.eid)
ecs.ShadowMaterial.commit(world, component.eid, false)

Dirty​

Mark the entity as having been mutated. Only needed in a specific case where systems are mutating data.

Example
ecs.ShadowMaterial.dirty(world, component.eid)