blender/source/gameengine/PyDoc/SCA_PythonController.py
Campbell Barton 6a3e8e7fff BGE python api addition, GameObject get/setState and Controller.getState()
Also added a note in the tooltip for action priority when using more then 1 action at a time.
2008-06-29 21:52:23 +00:00

58 lines
1.3 KiB
Python

# $Id$
# Documentation for SCA_PythonController
from SCA_IController import *
class SCA_PythonController(SCA_IController):
"""
A Python controller uses a Python script to activate it's actuators,
based on it's sensors.
"""
def getSensors():
"""
Gets a list of all sensors attached to this controller.
@rtype: list [L{SCA_ISensor}]
"""
def getSensor(name):
"""
Gets the named linked sensor.
@type name: string
@rtype: L{SCA_ISensor}
"""
def getActuators():
"""
Gets a list of all actuators linked to this controller.
@rtype: list [L{SCA_IActuator}]
"""
def getActuator(name):
"""
Gets the named linked actuator.
@type name: string
@rtype: L{SCA_IActuator}
"""
def getScript():
"""
Gets the Python script this controller executes.
@rtype: string
"""
def setScript(script):
"""
Sets the Python script this controller executes.
@type script: string.
"""
def getState():
"""
Get the controllers state bitmask, this can be used with the GameObject's state to test if the the controller is active.
This for instance will always be true however you could compare with a previous state to see when the state was activated.
GameLogic.getCurrentController().getState() & GameLogic.getCurrentController().getOwner().getState()
@rtype: int
"""