forked from bartvdbraak/blender
976e3a1824
Added Actuator documentation.
121 lines
3.3 KiB
Python
121 lines
3.3 KiB
Python
# $Id$
|
|
"""
|
|
Documentation for the GameLogic Module.
|
|
=======================================
|
|
|
|
There are only three importable modules in the game engine:
|
|
- GameLogic
|
|
- L{GameKeys}
|
|
- L{Rasterizer}
|
|
|
|
All the other modules are accessibly through the methods in GameLogic.
|
|
|
|
Examples::
|
|
# To get a controller:
|
|
import GameLogic
|
|
co = GameLogic.getCurrentController()
|
|
|
|
# To get the game object associated with this controller:
|
|
obj = co.getOwner()
|
|
L{KX_GameObject} and possibly L{KX_Camera} and L{KX_Light} methods are
|
|
available depending on the type of object::
|
|
# To get a sensor linked to this controller.
|
|
# "sensorname" is the name of the sensor as defined in the Blender interface.
|
|
sens = co.getSensor("sensorname")
|
|
L{KX_NetworkMessageSensor}, L{KX_RaySensor}, L{KX_TouchSensor}, L{SCA_KeyboardSensor},
|
|
L{SCA_MouseSensor}, L{SCA_PropertySensor} and L{SCA_RandomSensor} methods are available,
|
|
depending on the type of sensor::
|
|
# To get a list of all sensors:
|
|
sensors = co.B{getSensors}()
|
|
|
|
|
|
|
|
Constants
|
|
=========
|
|
- KX_TRUE: True value used by some modules
|
|
- KX_FALSE: False value used by some modules.
|
|
|
|
Property Sensor
|
|
---------------
|
|
Tests that the property sensor is able to perform. See L{SCA_PropertySensor}
|
|
- KX_PROPSENSOR_EQUAL: Activate when the property is equal to the sensor value.
|
|
- KX_PROPSENSOR_NOTEQUAL: Activate when the property is not equal to the sensor value.
|
|
- KX_PROPSENSOR_INTERVAL: Activate when the property is between the specified limits.
|
|
- KX_PROPSENSOR_CHANGED: Activate when the property changes
|
|
- KX_PROPSENSOR_EXPRESSION: Activate when the expression matches
|
|
|
|
Constraint Actuator
|
|
-------------------
|
|
The axis and type (location/rotation) of constraint. See L{KX_ConstraintActuator}
|
|
- KX_CONSTRAINTACT_LOCX
|
|
- KX_CONSTRAINTACT_LOCY
|
|
- KX_CONSTRAINTACT_LOCZ
|
|
- KX_CONSTRAINTACT_ROTX
|
|
- KX_CONSTRAINTACT_ROTY
|
|
- KX_CONSTRAINTACT_ROTZ
|
|
|
|
IPO Actuator
|
|
------------
|
|
IPO Types. See L{KX_IpoActuator}
|
|
- KX_IPOACT_PLAY
|
|
- KX_IPOACT_PINGPONG
|
|
- KX_IPOACT_FLIPPER
|
|
- KX_IPOACT_LOOPSTOP
|
|
- KX_IPOACT_LOOPEND
|
|
|
|
Random Distributions
|
|
--------------------
|
|
See L{SCA_RandomActuator}
|
|
- KX_RANDOMACT_BOOL_CONST
|
|
- KX_RANDOMACT_BOOL_UNIFORM
|
|
- KX_RANDOMACT_BOOL_BERNOUILLI
|
|
- KX_RANDOMACT_INT_CONST
|
|
- KX_RANDOMACT_INT_UNIFORM
|
|
- KX_RANDOMACT_INT_POISSON
|
|
- KX_RANDOMACT_FLOAT_CONST
|
|
- KX_RANDOMACT_FLOAT_UNIFORM
|
|
- KX_RANDOMACT_FLOAT_NORMAL
|
|
- KX_RANDOMACT_FLOAT_NEGATIVE_EXPONENTIAL
|
|
|
|
"""
|
|
|
|
|
|
def getCurrentController():
|
|
"""
|
|
Gets the Python controller associated with this Python script.
|
|
|
|
@rtype: L{SCA_PythonController}
|
|
"""
|
|
def addActiveActuator(actuator, activate):
|
|
"""
|
|
Activates the given actuator.
|
|
|
|
@type actuator: L{SCA_IActuator}
|
|
@type activate: boolean
|
|
@param activate: whether to activate or deactivate the given actuator.
|
|
"""
|
|
def getRandomFloat():
|
|
"""
|
|
Returns a random floating point value in the range [0...1)
|
|
"""
|
|
def setGravity(gravity):
|
|
"""
|
|
Sets the world gravity.
|
|
|
|
@type gravity: list [fx, fy, fz]
|
|
"""
|
|
def getSpectrum():
|
|
"""
|
|
Returns a 512 point list from the sound card.
|
|
This only works if the fmod sound driver is being used.
|
|
|
|
@rtype: list [float], len(getSpectrum()) == 512
|
|
"""
|
|
def stopDSP():
|
|
"""
|
|
Stops the sound driver using DSP effects.
|
|
|
|
Only the fmod sound driver supports this.
|
|
DSP can be computationally expensive.
|
|
"""
|