2004-06-02 12:43:27 +00:00
|
|
|
# $Id$
|
|
|
|
# Documentation for KX_CameraActuator
|
|
|
|
from SCA_ILogicBrick import *
|
|
|
|
|
|
|
|
class SCA_IController(SCA_ILogicBrick):
|
|
|
|
"""
|
|
|
|
Base class for all controller logic bricks.
|
2009-05-06 09:12:08 +00:00
|
|
|
|
|
|
|
@ivar state: the controllers state bitmask.
|
|
|
|
This can be used with the GameObject's state to test if the controller is active.
|
|
|
|
@type state: int bitmask
|
|
|
|
@ivar sensors: a list of sensors linked to this controller
|
|
|
|
- note: the sensors are not necessarily owned by the same object.
|
|
|
|
- note: when objects are instanced in dupligroups links may be lost from objects outside the dupligroup.
|
2009-05-10 01:48:14 +00:00
|
|
|
@type sensors: sequence supporting index/string lookups and iteration.
|
2009-05-06 09:12:08 +00:00
|
|
|
@ivar actuators: a list of actuators linked to this controller.
|
|
|
|
- note: the sensors are not necessarily owned by the same object.
|
|
|
|
- note: when objects are instanced in dupligroups links may be lost from objects outside the dupligroup.
|
2009-05-10 01:48:14 +00:00
|
|
|
@type actuators: sequence supporting index/string lookups and iteration.
|
2009-05-06 09:12:08 +00:00
|
|
|
|
2009-05-10 01:48:14 +00:00
|
|
|
@group Deprecated: getState, getSensors, getActuators, getSensor, getActuator
|
2004-06-02 12:43:27 +00:00
|
|
|
"""
|
|
|
|
|
2009-05-06 09:12:08 +00:00
|
|
|
def getState():
|
|
|
|
"""
|
|
|
|
DEPRECATED: use the state property
|
|
|
|
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
|
|
|
|
"""
|
|
|
|
def getSensors():
|
|
|
|
"""
|
|
|
|
DEPRECATED: use the sensors property
|
|
|
|
Gets a list of all sensors attached to this controller.
|
|
|
|
|
|
|
|
@rtype: list [L{SCA_ISensor}]
|
|
|
|
"""
|
|
|
|
def getSensor(name):
|
|
|
|
"""
|
2009-05-10 01:48:14 +00:00
|
|
|
DEPRECATED: use the sensors[name] property
|
2009-05-06 09:12:08 +00:00
|
|
|
Gets the named linked sensor.
|
|
|
|
|
|
|
|
@type name: string
|
|
|
|
@rtype: L{SCA_ISensor}
|
|
|
|
"""
|
|
|
|
def getActuators():
|
|
|
|
"""
|
|
|
|
DEPRECATED: use the actuators property
|
|
|
|
Gets a list of all actuators linked to this controller.
|
|
|
|
|
|
|
|
@rtype: list [L{SCA_IActuator}]
|
|
|
|
"""
|
|
|
|
def getActuator(name):
|
|
|
|
"""
|
2009-05-10 01:48:14 +00:00
|
|
|
DEPRECATED: use the actuators[name] property
|
2009-05-06 09:12:08 +00:00
|
|
|
Gets the named linked actuator.
|
|
|
|
|
|
|
|
@type name: string
|
|
|
|
@rtype: L{SCA_IActuator}
|
|
|
|
"""
|
|
|
|
|