Difference between revisions of "API Panel.Collision.TestTable"

From Flowcode Help
Jump to navigationJump to search
(XML Import to change Variable types into Variable Types)
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<sidebar>API contents</sidebar>
+
{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
Tests whether an object collides with the table top, returns Z distance to move to rest on the table
+
|-
 +
| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
 +
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''TestTable'''
 +
|-
 +
| colspan="2" | Tests whether an object collides with the table top, returns Z distance to move to rest on the table&nbsp;
 +
|-
 +
|-
 +
| width="10%" align="center" | [[File:Fc9-h32-icon.png]] - HANDLE
 +
| width="90%" | Pos
 +
|-
 +
| colspan="2" | A component or position to focus the collision around&nbsp;
 +
|-
 +
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-f32-icon.png]] - FLOAT
 +
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 +
|}
  
<div style="width:25%; float:right" class="toc">
 
====Class hierarchy====
 
[[API Panel|Panel]]
 
:[[API Panel.Collision|Collision]]
 
::[[API Panel.Collision|TestTable]]
 
</div>
 
__TOC__
 
  
==Parameters==
+
==Detailed description==
[[Variable Types|HANDLE]] ''Pos''
+
This calculates the distance between the lowest point on the objects bounding box and the table top, which is an infinite plane with Z = 0.
:A component or position to focus the collision around
+
[[File:API Panel.Collision.TestTable Diff.svg|thumb|none|200px|Distance to the table]]
 
 
 
 
==Return value==
 
[[Variable Types|FLOAT]]
 
  
Returns Z distance to move to rest on the table
+
The value returned is the distance to move in Z in order for the lowest point to lie on the table top. Note that this is not the same as the distance ''from'' the table which would be positive if the object was above the table, where as this would return the negative distance as the object would need to move down
 
 
 
 
==Detailed description==
 
''<span style="color:red;">No additional information</span>''
 
  
  
Line 29: Line 28:
 
* Declare a variable 'result' of type FLOAT
 
* Declare a variable 'result' of type FLOAT
 
* Add to a calculation icon: <pre class="brush:[cpp]">result = ::Panel.Collision.TestTable(pos)</pre>
 
* Add to a calculation icon: <pre class="brush:[cpp]">result = ::Panel.Collision.TestTable(pos)</pre>
 
''<span style="color:red;">No additional information</span>''
 

Latest revision as of 11:55, 16 January 2023

Fc9-comp-macro.png TestTable
Tests whether an object collides with the table top, returns Z distance to move to rest on the table 
Fc9-h32-icon.png - HANDLE Pos
A component or position to focus the collision around 
Fc9-f32-icon.png - FLOAT Return


Detailed description

This calculates the distance between the lowest point on the objects bounding box and the table top, which is an infinite plane with Z = 0.

Distance to the table

The value returned is the distance to move in Z in order for the lowest point to lie on the table top. Note that this is not the same as the distance from the table which would be positive if the object was above the table, where as this would return the negative distance as the object would need to move down


Examples

Calling in a calculation

  • Declare a variable 'result' of type FLOAT
  • Add to a calculation icon:
    result = ::Panel.Collision.TestTable(pos)