KX_BatchGroup

Classe base: EXP_Value

O batch group é uma classe que contém uma malha resultante da junção das malhas usadas por objetos. As malhas são juntadas com a transformação dos objetos que as usam. Uma instância desta classe não pertence a um objeto, mas é compartilhada entre objetos. Por isso, uma instância de KX_BatchGroup precisa ser criada passando como argumento uma lista de pelo menos um objeto com as malhas a juntar. Dá para fazer isso de um jeito parecido com:

import Range

scene = Range.logic.getCurrentScene()

batchGroup = types.KX_BatchGroup([scene.objects["Cube"], scene.objects["Plane"]])

Cuidado

Configurações de render próprias de cada objeto, como KX_GameObject.layer e KX_GameObject.color, são compartilhadas ao usar batch groups. Elas vêm do objeto referenceObject.

objects

A lista dos objetos juntados (somente leitura).

Tipo: EXP_ListValue of KX_GameObject

referenceObject

O objeto usado para as configurações de render (layer, cor…).

merge(objects)

Junta as malhas usando a transformação dos objetos que as usam.

• objects: Os objetos a juntar.
  • tipo: EXP_ListValue of KX_GameObject

split(objects)

Separa as malhas dos objetos e restaura as malhas originais.

• objects: Os objetos a separar.
  • tipo: EXP_ListValue of KX_GameObject

destruct()

Destrói o batch group e restaura todos os objetos para as malhas originais.