[Bf-blender-cvs] SVN commit: /data/svn/bf-blender [38211] trunk/blender/doc/python_api: patch [#27885] bge.constraints documentation
Campbell Barton
ideasman42 at gmail.com
Fri Jul 8 04:59:26 CEST 2011
Revision: 38211
http://projects.blender.org/scm/viewvc.php?view=rev&root=bf-blender&revision=38211
Author: campbellbarton
Date: 2011-07-08 02:59:25 +0000 (Fri, 08 Jul 2011)
Log Message:
-----------
patch [#27885] bge.constraints documentation
by Solano Felicio (solano)
Modified Paths:
--------------
trunk/blender/doc/python_api/sphinx_doc_gen.py
Added Paths:
-----------
trunk/blender/doc/python_api/rst/bge.constraints.rst
Added: trunk/blender/doc/python_api/rst/bge.constraints.rst
===================================================================
--- trunk/blender/doc/python_api/rst/bge.constraints.rst (rev 0)
+++ trunk/blender/doc/python_api/rst/bge.constraints.rst 2011-07-08 02:59:25 UTC (rev 38211)
@@ -0,0 +1,199 @@
+
+Game Engine bge.constraints Module
+==================================
+
+.. note::
+ This documentation is still very weak, and needs some help!
+
+.. function:: createConstraint([obj1, [obj2, [restLength, [restitution, [damping]]]]])
+
+ Creates a constraint.
+
+ :arg obj1: first object on Constraint
+ :type obj1: :class:'bge.types.KX_GameObject' #I think, there is no error when I use one
+
+ :arg obj2: second object on Constraint
+ :type obj2: :class:'bge.types.KX_GameObject' #too
+
+ :arg restLength: #to be filled
+ :type restLength: float
+
+ :arg restitution: #to be filled
+ :type restitution: float
+
+ :arg damping: #to be filled
+ :type damping: float
+
+.. attribute:: error
+
+ Simbolic constant string that indicates error.
+
+.. function:: exportBulletFile(filename)
+
+ export a .bullet file
+
+ :arg filename: File name
+ :type filename: string
+
+.. function:: getAppliedImpulse(constraintId)
+
+ :arg constraintId: The id of the constraint.
+ :type constraintId: int
+
+ :return: the most recent applied impulse.
+ :rtype: float
+
+.. function:: getVehicleConstraint(constraintId)
+
+ :arg constraintId: The id of the vehicle constraint.
+ :type constraintId: int
+
+ :return: a vehicle constraint object.
+ :rtype: :class:'KX_VehicleWrapper'
+
+.. function:: removeConstraint(constraintId)
+
+ Removes a constraint.
+
+ :arg constraintId: The id of the constraint to be removed.
+ :type constraintId: int
+
+.. function:: setCcdMode(ccdMode)
+
+ ..note::
+ Very experimental, not recommended
+
+ Sets the CCD mode in the Physics Environment.
+
+ :arg ccdMode: The new CCD mode.
+ :type ccdMode: int
+
+.. function:: setContactBreakingTreshold(breakingTreshold)
+
+ .. note::
+ Reasonable default is 0.02 (if units are meters)
+
+ Sets the contact breaking treshold in the Physics Environment.
+
+ :arg breakingTreshold: The new contact breaking treshold.
+ :type breakingTreshold: float
+
+.. function:: setDeactivationAngularTreshold(angularTreshold)
+
+ Sets the deactivation angular treshold.
+
+ :arg angularTreshold: New deactivation angular treshold.
+ :type angularTreshold: float
+
+.. function:: setDeactivationLinearTreshold(linearTreshold)
+
+ Sets the deactivation linear treshold.
+
+ :arg linearTreshold: New deactivation linear treshold.
+ :type linearTreshold: float
+
+.. function:: setDeactivationTime(time)
+
+ Sets the time after which a resting rigidbody gets deactived.
+
+ :arg time: The deactivation time.
+ :type time: float
+
+.. function:: setDebugMode(mode)
+
+ Sets the debug mode.
+
+ Debug modes:
+ - No debug: 0
+ - Draw wireframe: 1
+ - Draw Aabb: 2 #What's Aabb?
+ - Draw freatures text: 4
+ - Draw contact points: 8
+ - No deactivation: 16
+ - No help text: 32
+ - Draw text: 64
+ - Profile timings: 128
+ - Enable sat comparision: 256
+ - Disable Bullet LCP: 512
+ - Enable CCD: 1024
+ - Draw Constraints: #(1 << 11) = ?
+ - Draw Constraint Limits: #(1 << 12) = ?
+ - Fast Wireframe: #(1 << 13) = ?
+
+ :arg mode: The new debug mode.
+ :type mode: int
+
+.. function:: setGravity(x, y, z)
+
+ Sets the gravity force.
+
+ :arg x: Gravity X force.
+ :type x: float
+
+ :arg y: Gravity Y force.
+ :type y: float
+
+ :arg z: Gravity Z force.
+ :type z: float
+
+.. function:: setLinearAirDamping(damping)
+
+ Not implemented.
+
+.. function:: setNumIterations(numiter)
+
+ Sets the number of iterations for an iterative constraint solver.
+
+ :arg numiter: New number of iterations.
+ :type numiter: int
+
+.. function:: setNumTimeSubSteps(numsubstep)
+
+ Sets the number of substeps for each physics proceed. Tradeoff quality for performance.
+
+ :arg numsubstep: New number of substeps.
+ :type numsubstep: int
+
+.. function:: setSolverDamping(damping)
+
+ ..note::
+ Very experimental, not recommended
+
+ Sets the solver damping.
+
+ :arg damping: New damping for the solver.
+ :type damping: float
+
+.. function:: setSolverTau(tau)
+
+ .. note::
+ Very experimental, not recommended
+
+ Sets the solver tau.
+
+ :arg tau: New tau for the solver.
+ :type tau: float
+
+.. function:: setSolverType(solverType)
+
+ .. note::
+ Very experimental, not recommended
+
+ Sets the solver type.
+
+ :arg solverType: The new type of the solver.
+ :type solverType: int
+
+.. function:: setSorConstant(sor)
+
+ .. note::
+ Very experimental, not recommended
+
+ Sets the sor constant.
+
+ :arg sor: New sor value.
+ :type sor: float
+
+.. function:: setUseEpa(epa)
+
+ Not implemented.
Modified: trunk/blender/doc/python_api/sphinx_doc_gen.py
===================================================================
--- trunk/blender/doc/python_api/sphinx_doc_gen.py 2011-07-07 21:14:36 UTC (rev 38210)
+++ trunk/blender/doc/python_api/sphinx_doc_gen.py 2011-07-08 02:59:25 UTC (rev 38211)
@@ -989,6 +989,7 @@
fw("\n")
fw("* `Quickstart Intro <http://wiki.blender.org/index.php/Dev:2.5/Py/API/Intro>`_ if you are new to scripting in blender and want to get you're feet wet!\n")
fw("* `Blender/Python Overview <http://wiki.blender.org/index.php/Dev:2.5/Py/API/Overview>`_ for a more complete explanation of python integration in blender\n")
+ fw("\n")
fw("===================\n")
fw("Application Modules\n")
@@ -1050,6 +1051,7 @@
fw(" bge.render.rst\n\n")
fw(" bge.texture.rst\n\n")
fw(" bge.events.rst\n\n")
+ fw(" bge.constraints.rst\n\n")
# rna generated change log
fw("========\n")
@@ -1185,6 +1187,7 @@
shutil.copy2(os.path.join(BASEPATH, "..", "rst", "bge.render.rst"), BASEPATH)
shutil.copy2(os.path.join(BASEPATH, "..", "rst", "bge.texture.rst"), BASEPATH)
shutil.copy2(os.path.join(BASEPATH, "..", "rst", "bge.events.rst"), BASEPATH)
+ shutil.copy2(os.path.join(BASEPATH, "..", "rst", "bge.constraints.rst"), BASEPATH)
shutil.copy2(os.path.join(BASEPATH, "..", "rst", "change_log.rst"), BASEPATH)
More information about the Bf-blender-cvs
mailing list