blender/source/gameengine/PyDoc/KX_TouchSensor.py
Campbell Barton 6bfb8ca6b0 - Attributes for the collision sensor: propertyName, materialCheck, pulseCollisions, objectHit and objectHitList.
Removed a check in Python API touch.setProperty() for the property name on the sensor owner before allowing the name to be set - it makes no sense and isnt checked when creating the sensor.
- SCA_DelaySensor.py indent error making epydoc fail.
2009-02-26 04:17:23 +00:00

61 lines
1.8 KiB
Python

# $Id$
# Documentation for KX_TouchSensor
from SCA_ISensor import *
from KX_GameObject import *
class KX_TouchSensor(SCA_ISensor):
"""
Touch sensor detects collisions between objects.
@ivar propertyName: The name of the property or material this sensor detects (depending on the materialCheck property).
@type propertyName: string
@ivar materialCheck: when enabled this sensor checks for object materials rather then properties.
@type materialCheck: bool
@ivar pulseCollisions: The last collided object.
@type pulseCollisions: bool
@ivar objectHit: The last collided object. (Read Only)
@type objectHit: L{KX_GameObject} or None
@ivar objectHitList: A list of colliding objects. (Read Only)
@type objectHitList: list
"""
def setProperty(name):
"""
DEPRECATED: use the propertyName property
Set the property or material to collide with. Use
setTouchMaterial() to switch between properties and
materials.
@type name: string
"""
def getProperty():
"""
DEPRECATED: use the propertyName property
Returns the property or material to collide with. Use
getTouchMaterial() to find out whether this sensor
looks for properties or materials. (B{deprecated})
@rtype: string
"""
def getHitObject():
"""
DEPRECATED: use the objectHit property
Returns the last object hit by this touch sensor. (B{deprecated})
@rtype: L{KX_GameObject}
"""
def getHitObjectList():
"""
DEPRECATED: use the objectHitList property
Returns a list of all objects hit in the last frame. (B{deprecated})
Only objects that have the requisite material/property are listed.
@rtype: list [L{KX_GameObject}]
"""
def getTouchMaterial():
"""
DEPRECATED: use the materialCheck property
Returns KX_TRUE if this sensor looks for a specific material,
KX_FALSE if it looks for a specific property. (B{deprecated})
"""