Function _IrrAddCollisionAnimator

au3Irr2

au3Irr2 Function Reference

_IrrAddCollisionAnimator

Animator applying collision detection and gravity to its parent node.

#Include <au3Irrlicht2.au3>
_IrrAddCollisionAnimator($h_IrrSelector, $h_Node, $f_RadiusX, $f_RadiusY, $f_RadiusZ, $f_GravityX, $f_GravityY, $f_GravityZ, $f_OffsetX, $f_OffsetY, $f_OffsetZ)

Parameters

$h_IrrSelector	Handle of a selecor object as created with _IrrGetCollision[...] The selector represents a selection of triangles in the scene, this is usually all of the triangles in a map for instance.
$h_Node	Handle of a scene node to be collided against the selector.
$f_RadiusX, $f_RadiusY, $f_RadiusZ	Define an ellipsoid that defines the area of collision this eliptical shape allows the collision detection to slide the object up steps and even ladders. If you make it too big you might be too large to get through a doorway but if you make it too small you may not be able to climb steps. You should play with these values and find the best ones for your scene.
$f_GravityX, $f_GravityY, $f_GravityZ	Specify the force that is applied to the node for each axis. For example 0.0,-9.8,0.0 defines a typical downward force. Other values could be used to simulate e.g. wind effects.
$f_OffsetX, $f_OffsetY, $f_OffsetZ	Offset the node by a specific distance from the center of the collision. As the center of the object and the size of your collision ellipsoid vary you can use this to adjust the position of the node and to bring it into contact with the ground.

Return Value

Success: Handle of the created animator.
Failure: False

Remarks

The collision detection will stop the object penetrating through a surface in the objects it is colliding against and will also press it against the surface using gravity.

Example

#include "au3Irrlicht2.au3"

_IrrStart()

_IrrAddZipFile( "./media/map-20kdm2.pk3", $IRR_IGNORE_CASE, $IRR_IGNORE_PATHS )
$meshBSP = _IrrGetMesh( "20kdm2.bsp" )
local $nodeBSP = _IrrAddMeshToSceneAsOcttree( $meshBSP )

local $nodeCamera = _IrrAddFPSCamera()
_IrrSetNodePosition( $nodeCamera, 1750, 149, 1369 )

local $selectorMap = _IrrGetCollisionGroupFromComplexMesh( $meshBSP, $nodeBSP )
local $animator = _IrrAddCollisionAnimator($selectorMap, $nodeCamera, _
                         30.0,30.0,30.0,   0.0,-9.8,0.0,   0.0,50.0,0.0 )

WHILE _IrrRunning()
    _IrrBeginScene(50, 50, 50)
    _IrrDrawScene()
    _IrrEndScene()
WEND

_IrrStop()

previous page start next page