Editing droptofloor

====Syntax:====
<code>float droptofloor(float yaw, float dist)</code>

Tries to "drop" an entity down up to 256 units in a single frame, as if it had fallen due to physics.
====Parameters:====
:<code>yaw</code> - Unused?
:<code>dist</code> - Unused?
====Returns:====
:Returns  TRUE if the entity landed on the ground and FALSE if it was still in the air.
====Other Details:====
Note the 256 unit limitation.  Typically droptofloor is either to pre-place items and monsters on the ground after a map has loaded but if an entity is  over 256 units from the ground, droptofloor will return false.

[[Category:QuakeC Function]]
@@ Line 1: / Line 1: @@
-''float'' '''droptofloor'''()
+====Syntax:====
+<code>float droptofloor(float yaw, float dist)</code>
-== Usage ==
+Tries to "drop" an entity down up to 256 units in a single frame, as if it had fallen due to physics.
-Tries to move an entity to the nearest floor beneath it, up to 256 map units. This is mostly for snapping item and monsters to the ground at map start, but this function shouldn't be called within the initializer functions themselves. Not all entities are guaranteed to be loaded in yet at map spawn, so it's best to wait at least a frame for everything to load in.
+====Parameters:====
+:<code>yaw</code> - Unused?
-'''Warning:''' The function assumes that self is the current entity trying to snap to the floor.
+:<code>dist</code> - Unused?
+====Returns:====
-=== Return ===
+:Returns  TRUE if the entity landed on the ground and FALSE if it was still in the air.
-Returns <code>TRUE</code> if the entity was placed on valid ground.
+====Other Details:====
+Note the 256 unit limitation.  Typically droptofloor is either to pre-place items and monsters on the ground after a map has loaded but if an entity is  over 256 units from the ground, droptofloor will return false.
-== Example ==
-  // This function tries to keep an entity stuck to the ground
- float MoveToGround(vector pos)
- {
-     vector curOrigin = self.origin;
-     setorigin(self, pos);
-     if (!droptofloor())
-     {
-         setorigin(self, curOrigin);
-         return FALSE;
-     }
-     return TRUE;
- }
 [[Category:QuakeC Function]]