This is just like the CapsuleCastNonAlloc() functions from Unity, all with the same physics cast processing, same parameters and same return type. The differences are only:
It draws a visualization for the cast
It adds 3 optional parameters to the end of the function signatures that only affect the visualization (namely "nameTag", "durationInSec" and "hiddenByNearerObjects")
You can just change the class prefix from existing code like "Physics.CapsuleCastNonAlloc()" becomes "DrawPhysics.CapsuleCastNonAlloc()" and it will work as before, but with the added visualization. In builds the visualization can be omitted by setting UsedUnityLineDrawingMethod to "disabled", but the cast and the returned function results will still work.
Note: This function has "NonAlloc" in its name to be consistent with the function names of the UnityEnigne.Physics class, but despite the version from UnityEnigne.Physics this function here in DrawXXL.DrawPhysics may allocate small amounts of memory garbage due to generation of the text description that gets displayed in the Scene view together with the cast visualisation.
Green parameters are required. Yellow parameters are optional, but have to be supplied in order.
static int DrawPhysics.CapsuleCastNonAlloc(...);
Code snippet names: drawCapsuleCastNonAlloc and drawCapsuleCastNonAlloc_func.
Parameters:
Type
Parameter Name
Description
Vector3
point1
Vector3
point2
float
radius
Vector3
direction
RaycastHit[]
results
float
maxDistance
int
layerMask
QueryTriggerInteraction
queryTriggerInteraction
string
nameTag
float
durationInSec
The duration in seconds how long the drawn thing stays visible. The default value of 0 means that it stays only during the current Update frame. Instead of using this parameter you can also overwrite him with a global setting so you don't always have to supply all other preceding function parameters till you reach this late parameter.
bool
hiddenByNearerObjects
This specifies if the drawn thing will get hidden if other geometry is in front of it or if it shines through. It is the same as the depthTest parameter of Unitys Debug.DrawLine(). Not all drawing methods support toggling this in the same way. For some methods the lines are fully hidden, for others the hidden lines shimmer through. Instead of using this parameter you can also overwrite him with a global setting so you don't always have to supply all other preceding function parameters till you reach this late parameter.