Difference between revisions of "Global Command: getWindowBrightness"

From The Official Visionaire Studio: Adventure Game Engine Wiki
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
<div class="toccolours mw-collapsible mw-collapsed tbl-ds">
+
Returns the brightness (gamma) of the window. A value of 0 is completely dark, 100 is normal brightness.
−
<span class="bold">Function History</span>
 
−
<div class="mw-collapsible-content">
 
−
<div class="alt-bg">Available since v3.8</div>
 
−
</div></div>
 
  
 +
{| class="ts"
 +
|-
 +
| style="width:15%" | Related functions
 +
| [[Global Command: setWindowBrightness|setWindowBrightness]]
 +
|}
  
−
Returns the integer value of global window brightness. (min = 0, max = 100)
 
  
−
 
+
== Syntax ==
−
Syntax:
+
<syntaxhighlight lang="lua">
−
<syntaxhighlight>
 
 
getWindowBrightness()
 
getWindowBrightness()
 
</syntaxhighlight>
 
</syntaxhighlight>
  
  
−
Example:
+
== Parameters ==
−
<syntaxhighlight>
 
−
-- check if brightness value is less than 50%?
 
−
if getWindowBrightness() < 50 then
 
−
-- do something...
 
−
end
 
−
</syntaxhighlight>
 
−
 
 
−
 
 
  
−
<span class="bold underline">Arguments</span><br/>
 
 
none
 
none
  
  
−
<span class="bold underline">Flags</span><br/>
+
== Return values ==
−
none
+
{| class="ts"
 +
|-
 +
! style="width:15%" | Type
 +
! Description
 +
|-
 +
| integer
 +
| The current gamma/brightness value in the range of 0 (completely dark) to 100 (normal brightness).
 +
|}
  
  
−
<span class="bold underline">Return</span><br/>
+
== Examples ==
−
'''brightness''' <br/>
 
−
The integer value of window brightness.
 
  
−
 
+
'''Example 1:''' Do something, if the brightness value is less than 50%.
−
 
+
<syntaxhighlight lang ="lua">
−
{| class="tbl-ds"
+
if getWindowBrightness() < 50 then
−
|-
+
  -- do something
−
|<span class="bold">Relevant Pages</span>: [[SetWindowBrightness_(CMS)|setVolume]]
+
end
−
|}
+
</syntaxhighlight>
 +
{{toc}}

Latest revision as of 23:45, 15 May 2023

Returns the brightness (gamma) of the window. A value of 0 is completely dark, 100 is normal brightness.

Related functions setWindowBrightness


Syntax

getWindowBrightness()


Parameters

none


Return values

Type Description
integer The current gamma/brightness value in the range of 0 (completely dark) to 100 (normal brightness).


Examples

Example 1: Do something, if the brightness value is less than 50%.

if getWindowBrightness() < 50 then
  -- do something
end