KX_PolyProxy(SCA_IObject)
base class — SCA_IObject
- class bge.types.KX_PolyProxy
A polygon holds the index of the vertex forming the poylgon. You can only read the vertex properties of a mesh object. In upbge 0.3+, KX_MeshProxy, KX_PolyProxy, and KX_VertexProxy are only a representation of the physics shape as it was when it was converted in BL_DataConversion. Previously this kind of meshes were used both for render and physics, but since 0.3+, it is only useful in limited cases. In most cases, bpy API should be used instead.
Note: The physics simulation doesn’t currently update KX_Mesh/Poly/VertexProxy.
- material_name
The name of polygon material, empty if no material.
- Type
string
- material
The material of the polygon.
- Type
- 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
- vertices
Returns the list of vertices of this polygon.
- Type
KX_VertexProxy
list (read only)
- getMaterialName()
Returns the polygon material name with MA prefix
- Returns
material name
- Return type
string
- getMaterial()
- Returns
The polygon material
- Return type
- 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
KX_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
KX_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