KX_PolyProxy(SCA_IObject)

base class — SCA_IObject

class bge.types.KX_PolyProxy(SCA_IObject)

A polygon holds the index of the vertex forming the poylgon.

Note: The polygon attributes are read-only, you need to retrieve the vertex proxy if you want to change the vertex settings.

material_name

The name of polygon material, empty if no material.

Type:string

material

The material of the polygon.

Type:KX_PolygonMaterial or KX_BlenderMaterial

texture_name

The texture name of the polygon.

Type:string

material_id

The material index of the polygon, use this to retrieve vertex proxy from mesh proxy.

Type:integer

v1

vertex index of the first vertex of the polygon, use this to retrieve vertex proxy from mesh proxy.

Type:integer

v2

vertex index of the second vertex of the polygon, use this to retrieve vertex proxy from mesh proxy.

Type:integer

v3

vertex index of the third vertex of the polygon, use this to retrieve vertex proxy from mesh proxy.

Type:integer

v4

Vertex index of the fourth vertex of the polygon, 0 if polygon has only 3 vertex Use this to retrieve vertex proxy from mesh proxy.

Type:integer

visible

visible state of the polygon: 1=visible, 0=invisible.

Type:integer

collide

collide state of the polygon: 1=receives collision, 0=collision free.

Type:integer

getMaterialName()

Returns the polygon material name with MA prefix

Returns:material name Return type:string

getMaterial()

Returns:The polygon material Return type:KX_PolygonMaterial or KX_BlenderMaterial

getTextureName()

Returns:The texture name Return type:string

getMaterialIndex()

Returns the material bucket index of the polygon. This index and the ones returned by getVertexIndex() are needed to retrieve the vertex proxy from MeshProxy.

Returns:the material index in the mesh Return type:integer

getNumVertex()

Returns the number of vertex of the polygon.

Returns:number of vertex, 3 or 4. Return type:integer

isVisible()

Returns whether the polygon is visible or not

Returns:0=invisible, 1=visible Return type:boolean

isCollider()

Returns whether the polygon is receives collision or not

Returns:0=collision free, 1=receives collision Return type:integer

getVertexIndex(vertex)

Returns the mesh vertex index of a polygon vertex This index and the one returned by getMaterialIndex() are needed to retrieve the vertex proxy from MeshProxy.

Parameters:

• vertex – index of the vertex in the polygon: 0->3
• vertex – integer

Returns:

mesh vertex index

Return type:

integer

getMesh()

Returns a mesh proxy

Returns:mesh proxy Return type:MeshProxy