{{tag>physics collider collision shape}}
<WRAP youarehere>
[[:start|Start Page]] >> [[:gamedev|Game Development with the Drag[en]gine]] >> [[gamedev:colliders|Physics with colliders]] >> **Collision shapes**
</WRAP>

====== Shapes ======

Shapes are used mainly in colliders to define the over all shape of a collider. Shapes can though also be used for [[gamedev:debugdrawers|Debug Drawers]] which allows to display physics structures easily. Shapes are analytical geometry and always convex. Combining shapes is always an union. Hence combined shapes can very well be concave but not the individual shapes itself.

====== Sphere ======
A sphere is defined by a position and a radius. Ellipsoids are not supported by this shape only true spheres.
^  Parameter  ^  Description  ^  Default  ^
|Position|The position of the sphere center.|(0,0,0)|
|Radius|The length of the radius from the center to the sphere boundary.|0.5|

====== Box ======
A box is defined by a position, orientation and the half length of the extends.
^  Parameter  ^  Description  ^  Default  ^
|Position|The position of the box center.|(0,0,0)|
|Orientation|The orientation of the box expressed as a quaternion.|(0,0,0,1)|
|Half Extends|The half length of the box main axes or extends.|(0.5,0.5,0.5)|

====== Cylinder ======
A cylinder is defined by a position, orientation, half height and twwo radi. The cylinder is centered around the position and has the major axis point upwards along the Y-Axis. The half height indicates half the length of the cylinder ( from the top face to the bottom face ). The top and bottom radius indicate the radius of the top and bottom face circle. If both are the same the cylinder is a common cylinder otherwise it is a tapered cylinder.
^  Parameter  ^  Description  ^  Default  ^
|Position|The position of the cylinder center.|(0,0,0)|
|Orientation|The orientation of the cylinder expressed as a quaternion.|(0,0,0,1)|
|Half Height|Half the height of the cylinder along the Y-Axis|0.5|
|Top Radius|Radius of the top circle face of the cylinder|0.5|
|Bottom Radius|Radius of the bottom circle face of the cylinder|0.5|

====== Capsule ======
A capsule is defined by a position, orientation, half height and two radi. The capsule is centered around the position and has the major axis point upwards along the Y-Axis. The half height indicates half the length of the capsule ( from the top sphere to the bottom sphere ). The top and bottom radius indicate the radius of the top and bottom sphere. If both are the same the capsule is a common capsule otherwise it is a tapered capsule.
^  Parameter  ^  Description  ^  Default  ^
|Position|The position of the capsule center.|(0,0,0)|
|Orientation|The orientation of the capsule expressed as a quaternion.|(0,0,0,1)|
|Half Height|Half the height of the capsule along the Y-Axis|0.5|
|Top Radius|Radius of the top circle face of the capsule|0.5|
|Bottom Radius|Radius of the bottom circle face of the capsule|0.5|

====== Hull ======
A convex hull is defined by a position, orientation, and a list of points. The hull shape is defined as the convex hull wrapping all points. Think of it like wrapping the points into a gift paper.
^  Parameter  ^  Description  ^  Default  ^
|Position|The position of the capsule center.|(0,0,0)|
|Orientation|The orientation of the capsule expressed as a quaternion.|(0,0,0,1)|
|Points|List of points as 3-Vector values|empty list|