======Request Entity======
----

Prompts the player for an [[entity]] using the cursor. The selected [[entity]] is returned by this function and can be stored into a property or variable for further action.

====Signature:====
<code python>
request_entity(validation_func)
</code>

^Argument^Description^Type^Required^
|validation_func|Name of custom function that is called to validate the [[entity]] at the current cursor location. If supplied, this function should have one input argument, into which the current [[entity]] will be passed.|[[String]]|No|

====Example:====
<code bauxite>
function validate_entity($selected) begin
  $entity_type = $selected.type;
  return $entity_type == OBJECT;
end;
$result = request_entity("validate_entity");
</code>
//Results://
Prompts the player for an [[entity]]. The custom "validate_entity" function is called to validate whether or not the [[entity]] at the current cursor location is an [[object]].

<WRAP center round tip 100%>
Use the **Request Entity** function as a way for the player to dynamically manipulate the scene, for example to pick a decorative [[object]] in their house and then rotate or scale it.
</WRAP>

----

<WRAP group>
<WRAP half column>
====Editor Node:====
</WRAP>

<WRAP half column>
====Visual Demo:====
</WRAP>
</WRAP>

~~NOTOC~~