47c2271d67
* bugfix for BGE python api - SetParent actuator getObject would segfault if the object was not set. * Added utility function ConvertPythonToGameObject() that can take a GameObject, string or None and set the game object from this since it was being done in a number of places. * allow setObject(None), since no object is valid for actuators, Python should be able to set this. * added optional argument for getObject() so it returns the KX_GameObject rather then its name, would prefer this be default but it could break existing games.
89 lines
1.7 KiB
Python
89 lines
1.7 KiB
Python
# $Id$
|
|
# Documentation for KX_CameraActuator
|
|
from SCA_IActuator import *
|
|
|
|
class KX_CameraActuator(SCA_IActuator):
|
|
"""
|
|
Applies changes to a camera.
|
|
|
|
@author: snail
|
|
"""
|
|
def getObject(name_only = 1):
|
|
"""
|
|
Returns the name of the object this actuator tracks.
|
|
|
|
@type name_only: bool
|
|
@param name_only: optional argument, when 0 return a KX_GameObject
|
|
@rtype: string, KX_GameObject or None if no object is set
|
|
"""
|
|
|
|
def setObject(target):
|
|
"""
|
|
Sets the object this actuator tracks.
|
|
|
|
@param target: the object to track.
|
|
@type target: L{KX_GameObject}, string or None
|
|
"""
|
|
|
|
def getMin():
|
|
"""
|
|
Returns the minimum distance to target maintained by the actuator.
|
|
|
|
@rtype: float
|
|
"""
|
|
|
|
def setMin(distance):
|
|
"""
|
|
Sets the minimum distance to the target object maintained by the
|
|
actuator.
|
|
|
|
@param distance: The minimum distance to maintain.
|
|
@type distance: float
|
|
"""
|
|
|
|
def getMax():
|
|
"""
|
|
Gets the maximum distance to stay from the target object.
|
|
|
|
@rtype: float
|
|
"""
|
|
|
|
def setMax(distance):
|
|
"""
|
|
Sets the maximum distance to stay from the target object.
|
|
|
|
@param distance: The maximum distance to maintain.
|
|
@type distance: float
|
|
"""
|
|
|
|
def getHeight():
|
|
"""
|
|
Returns the height to stay above the target object.
|
|
|
|
@rtype: float
|
|
"""
|
|
|
|
def setHeight(height):
|
|
"""
|
|
Sets the height to stay above the target object.
|
|
|
|
@type height: float
|
|
@param height: The height to stay above the target object.
|
|
"""
|
|
|
|
def setXY(xaxis):
|
|
"""
|
|
Sets the axis to get behind.
|
|
|
|
@param xaxis: False to track Y axis, True to track X axis.
|
|
@type xaxis: boolean
|
|
"""
|
|
|
|
def getXY():
|
|
"""
|
|
Returns the axis this actuator is tracking.
|
|
|
|
@return: True if tracking X axis, False if tracking Y axis.
|
|
@rtype: boolean
|
|
"""
|