PhysicsSetPosition and rotation not listed

[AggrorJorn]

In the Entity class API documentation: https://www.leadwerks.com/docs.php?page=API-Reference_Object_Entity, the commands https://www.leadwerks.com/docs?page=API-Reference_Object_Entity_PhysicsSetPosition and https://www.leadwerks.com/docs?page=API-Reference_Object_Entity_PhysicsSetRotation are not listed.

[Core]

I think Josh mentioned somewhere that kinematic joints are ment to replace those commands and allthough they can still be used, it is adviced to use new ones. That is the reason they are removed from the reference.

[gamecreator]

I used world->FindEntity yesterday and was surprised to not find it in the docs either.  I assume that one is an unofficial function but it would be nice to know this somehow, for every function (whether they're unofficial or yet to be documented).

[Josh]

PhysicsSetPosition and PhysicsSetRotation have been removed from the docs and are only included in the engine for backwards compatibility.  The kinematic joint works much better.

[Marcousik]

Could we get an example for those new functions ?

• Joint Kinematic(number posx, number posy, number posz, Entity entity)

For example for this one, what should be (posx, posy, posz) ? The entity:GetPosition(true) ??

thx

[Josh]

Yes, that is what I would use.

The other relevant functions are SetTargetPosition(), SetTargetRotation(), and SetFriction().

[Marcousik]

thx Josh, one more thing, would this be right (as part of a script): 

 

local JointExample=Joint:Kinematic(number posx, number posy, number posz, Entity entity)

JointExample:SetTargetRotation(Vec3 rotation, number blend=0.5)   -- this will rotate the entity atached

?

thx