======Set Ambient Light Enabled======
----

Enables or disables the [[map|map's]] [[ambient light]].

====Signature:====
<code python>
set_ambient_light_enabled(enabled)
</code>

^Argument^Description^Type^Required^
|enabled|Determines the [[ambient_light|ambient light's]] state (on or off).|[[Boolean]]|Yes|

<WRAP center round info 100%>
If you'd like to change the [[color]] of the [[ambient light]] instead of turning it on or off, see the related [[Set Ambient Light Color]] function.
</WRAP>

====Example:====
<code bauxite>
set_ambient_light_enabled(false);
</code>
//Results:// The [[map|map's]] [[ambient light]] is disabled and no longer affects the scene until enabled again.

<WRAP center round tip 100%>
Use the **Set Ambient Light Color** function to change the overall mood of a room or to complement another light source's [[color]] change.
</WRAP>

<WRAP group>
<WRAP half column>
====Editor Node:====
{{:wiki:set_ambient_light_enabled_node.png?nolink|}}
</WRAP>

<WRAP half column>
====Visual Demo:====
{{:wiki:set_ambient_light_enabled_demo.gif?nolink|}}
</WRAP>
</WRAP>

~~NOTOC~~