2004-06-02 12:43:27 +00:00
|
|
|
# $Id$
|
|
|
|
# Documentation for KX_SceneActuator
|
|
|
|
from SCA_IActuator import *
|
|
|
|
|
|
|
|
class KX_SceneActuator(SCA_IActuator):
|
|
|
|
"""
|
|
|
|
Scene Actuator logic brick.
|
|
|
|
|
|
|
|
@warning: Scene actuators that use a scene name will be ignored if at game start, the
|
|
|
|
named scene doesn't exist or is empty
|
2009-04-05 10:03:23 +00:00
|
|
|
|
2004-06-02 12:43:27 +00:00
|
|
|
This will generate a warning in the console:
|
|
|
|
|
|
|
|
C{ERROR: GameObject I{OBName} has a SceneActuator I{ActuatorName} (SetScene) without scene}
|
2009-03-27 21:54:16 +00:00
|
|
|
|
|
|
|
@ivar scene: the name of the scene to change to/overlay/underlay/remove/suspend/resume
|
|
|
|
@type scene: string.
|
|
|
|
@ivar camera: the camera to change to.
|
|
|
|
When setting the attribute, you can use either a L{KX_Camera} or the name of the camera.
|
|
|
|
@type camera: L{KX_Camera} on read, string or L{KX_Camera} on write
|
2009-05-03 09:21:58 +00:00
|
|
|
@ivar useRestart: Set flag to True to restart the sene
|
|
|
|
@type useRestart: bool
|
2009-05-06 09:12:08 +00:00
|
|
|
@ivar mode: The mode of the actuator
|
2009-05-02 02:40:11 +00:00
|
|
|
@type mode: int from 0 to 5 L{GameLogic.Scene Actuator}
|
2004-06-02 12:43:27 +00:00
|
|
|
"""
|
|
|
|
def setUseRestart(flag):
|
|
|
|
"""
|
2009-05-03 09:21:58 +00:00
|
|
|
DEPRECATED: use the useRestart property instead
|
2004-06-02 12:43:27 +00:00
|
|
|
Set flag to True to restart the scene.
|
|
|
|
|
|
|
|
@type flag: boolean
|
|
|
|
"""
|
|
|
|
def setScene(scene):
|
|
|
|
"""
|
2009-03-27 21:54:16 +00:00
|
|
|
DEPRECATED: use the scene property instead
|
2004-06-02 12:43:27 +00:00
|
|
|
Sets the name of the scene to change to/overlay/underlay/remove/suspend/resume.
|
|
|
|
|
|
|
|
@type scene: string
|
|
|
|
"""
|
|
|
|
def setCamera(camera):
|
|
|
|
"""
|
2009-03-27 21:54:16 +00:00
|
|
|
DEPRECATED: use the camera property instead
|
2004-07-17 05:28:23 +00:00
|
|
|
Sets the camera to change to.
|
2004-06-02 12:43:27 +00:00
|
|
|
|
2004-07-17 05:28:23 +00:00
|
|
|
Camera can be either a L{KX_Camera} or the name of the camera.
|
|
|
|
|
|
|
|
@type camera: L{KX_Camera} or string
|
2004-06-02 12:43:27 +00:00
|
|
|
"""
|
|
|
|
def getUseRestart():
|
|
|
|
"""
|
2009-05-03 09:21:58 +00:00
|
|
|
DEPRECATED: use the useRestart property instead
|
2004-06-02 12:43:27 +00:00
|
|
|
Returns True if the scene will be restarted.
|
|
|
|
|
|
|
|
@rtype: boolean
|
|
|
|
"""
|
|
|
|
def getScene():
|
|
|
|
"""
|
2009-03-27 21:54:16 +00:00
|
|
|
DEPRECATED: use the scene property instead
|
2004-06-02 12:43:27 +00:00
|
|
|
Returns the name of the scene to change to/overlay/underlay/remove/suspend/resume.
|
|
|
|
|
2004-09-19 01:33:08 +00:00
|
|
|
Returns an empty string ("") if no scene has been set.
|
|
|
|
|
2004-06-02 12:43:27 +00:00
|
|
|
@rtype: string
|
|
|
|
"""
|
|
|
|
def getCamera():
|
|
|
|
"""
|
2009-03-27 21:54:16 +00:00
|
|
|
DEPRECATED: use the camera property instead
|
2004-06-02 12:43:27 +00:00
|
|
|
Returns the name of the camera to change to.
|
|
|
|
|
|
|
|
@rtype: string
|
|
|
|
"""
|