lightIsOn: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (moved notes)
m (Text replacement - "<sqf>([^↵][^\/]*↵[^\/]*)<\/sqf>" to "<sqf> $1 </sqf>")
 
(74 intermediate revisions by 14 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| ofp |= Game name
|game1= ofp
|version1= 1.04


|1.04|= Game version
|game2= ofpe
____________________________________________________________________________________________
|version2= 1.00


| Check if lampost is on (shining). Possible values are:
|game3= arma1
* '''"ON"'''
|version3= 1.00
* '''"OFF"'''
* '''"AUTO"''' (auto is only on during the night).
|= Description
____________________________________________________________________________________________


| '''lightIsOn''' |= Syntax
|game4= arma2
|version4= 1.00


|p1= lamppost: [[Object]] |= Parameter 1
|game5= arma2oa
|version5= 1.50


| [[String]] |= Return value
|game6= tkoh
|version6= 1.00


____________________________________________________________________________________________
|game7= arma3
|version7= 0.50


|x1= <pre>lightIsOn [[nearestObject]] [[[player]], "StreetLamp"] != "OFF" _it = lightIsOn [[object]] 159582</pre> |=
|gr1= Lights
____________________________________________________________________________________________


| |= See also
|descr= Check if lampost is on (shining).
{{Feature|informative|A lamp state is '''local''' to each client (see [[switchLight]]).}}
{{Feature | arma3 | This command was originally designed to only work with CfgNonAIVehicles class "StreetLamp" only;
since {{arma3}} v1.92 this command was extended to work with street lights.}}


}}
|s1= [[lightIsOn]] lamppost
 
|p1= lamppost: [[Object]]


<h3 style="display:none">Notes</h3>
|r1= [[String]] - can be one of:
<dl class="command_description">
* '''"ON"''' - light is on
<!-- Note Section BEGIN -->
* '''"OFF"''' - light is off
* '''"AUTO"''' - applicable only to the light of type "StreetLamp" and is only on during the night.
* '''"ERROR"''' - if command fails


Use [[switchLight]] to turn lamposts on and off.
|x1= <sqf>if (lightIsOn nearestObject [player, "StreetLamp"] == "ON") then { hint "nightime"; };</sqf>


<!-- Note Section END -->
|x2= <sqf>_it = lightIsOn object 159582;</sqf>
</dl>


<h3 style="display:none">Bottom Section</h3>
|x3= <sqf>
if (count allMissionObjects "StreetLamp" == 0) then {
hint "Objects compatible with 'lightIsOn' are not found.";
} else {
hint "'lightIsOn' compatible objects are found!";
};
</sqf>


[[Category:Scripting Commands|LIGHTISON]]
|seealso= [[switchLight]]
[[Category:Scripting Commands OFP 1.96|LIGHTISON]]
}}
[[Category:Scripting Commands OFP 1.46|LIGHTISON]]
[[Category:Scripting Commands ArmA|LIGHTISON]]

Latest revision as of 11:34, 3 September 2024

Hover & click on the images for description

Description

Description:
Check if lampost is on (shining).
A lamp state is local to each client (see switchLight).
Arma 3
This command was originally designed to only work with CfgNonAIVehicles class "StreetLamp" only; since Arma 3 v1.92 this command was extended to work with street lights.
Groups:
Lights

Syntax

Syntax:
lightIsOn lamppost
Parameters:
lamppost: Object
Return Value:
String - can be one of:
  • "ON" - light is on
  • "OFF" - light is off
  • "AUTO" - applicable only to the light of type "StreetLamp" and is only on during the night.
  • "ERROR" - if command fails

Examples

Example 1:
if (lightIsOn nearestObject [player, "StreetLamp"] == "ON") then { hint "nightime"; };
Example 2:
_it = lightIsOn object 159582;
Example 3:
if (count allMissionObjects "StreetLamp" == 0) then { hint "Objects compatible with 'lightIsOn' are not found."; } else { hint "'lightIsOn' compatible objects are found!"; };

Additional Information

See also:
switchLight

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note