NewtonCreateSphere

From Newton Wiki
Revision as of 08:02, 10 June 2019 by WikiSysop (talk | contribs) (1 revision imported)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

NewtonCreateSphere

Syntax:

NewtonCollision* NewtonCreateSphere( const NewtonWorld* newtonWorld, dFloat radiusX, dFloat radiusY, dFloat radiusZ, const dFloat *offsetMatrix)

Usage

Create a generalized ellipsoid primitive.

Parameters

  • const NewtonWorld *newtonWorld - pointer to the Newton world.
  • dFloat radiusX - sphere radius along X axis.
  • dFloat radiusY - sphere radius along Y axis.
  • dFloat radiusZ - sphere radius along Z axis.
  • const dFloat *offsetMatrix - pointer to an array of 16 floats containing the offset matrix of the sphere relative to the * body. If this parameter is NULL then the sphere is centered at the origin of the body.

Return

  • Pointer to the generalized sphere.

Remarks

  • Sphere collision are generalized ellipsoids, the application can create many different kind of objects by just playing with dimensions of the radius. for example to make a sphere set all three radii to the same value, to make a ellipse of revolution just set two of the three radii to the same value.
  • General ellipsoids are very good hull geometries to represent the outer shell of avatars in a game.
  • Collision primitives are reference counted objects. The application should call NewtonReleaseCollision in order to release references to the object. Neglecting to release references to collision primitives is a common cause of memory leaks. Collision primitives can be reused with more than one body. This will reduce the amount of memory used be the engine, as well as speed up some calculations.

See also

NewtonReleaseCollisionNewtonCreateConvexHullModifier Newton SDK API reference#Category:convex_collision_primitives_creation_functions