lightIsOn: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(works with arma 3 lights now)
m (Text replacement - "<sqf>([^↵][^\/]*↵[^\/]*)<\/sqf>" to "<sqf> $1 </sqf>")
 
(56 intermediate revisions by 3 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). Originally was intended for working with CfgNonAIVehicles class "StreetLamp" only. Since Arma 3 v1.92 it could return the state of Arma 3 street lights. Possible values are:
|game3= arma1
* '''"ON"''' - light is on
|version3= 1.00
* '''"OFF"''' - light is off
* '''"AUTO"''' - applicable only to the light of type "StreetLamp" and is only on during the night.
* '''"ERROR"''' - when command fails


|= Description
|game4= arma2
____________________________________________________________________________________________
|version4= 1.00


| '''lightIsOn''' lamppost |= Syntax
|game5= arma2oa
|version5= 1.50


|p1= lamppost: [[Object]] |= Parameter 1
|game6= tkoh
|version6= 1.00


| [[String]] |= Return value
|game7= arma3
|version7= 0.50


____________________________________________________________________________________________
|gr1= Lights


|x1= <code>?'''lightIsOn''' [[nearestObject]] <nowiki>[</nowiki>[[player]], "StreetLamp"] <nowiki>==</nowiki> "ON" :hint "nightime"</code> |= Example 1
|descr= Check if lampost is on (shining).
|x2= <code>_it <nowiki>=</nowiki> lightIsOn [[object]] 159582</code> |= Example 2
{{Feature|informative|A lamp state is '''local''' to each client (see [[switchLight]]).}}
|x3 = <code>[[if]] ([[count]] [[allMissionObjects]] "StreetLamp" == 0) [[then]] {
{{Feature | arma3 | This command was originally designed to only work with CfgNonAIVehicles class "StreetLamp" only;
[[hint]] "Objects compatible with 'lightIsOn' are not found.";
since {{arma3}} v1.92 this command was extended to work with street lights.}}
} [[else]] {
[[hint]] "'lightIsOn' compatible objects are found!";
};</code>|=
____________________________________________________________________________________________


| [[switchLight]] |= See also
|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


<dd class="notedate">Posted on August 4, 2006 - 10:56
|x1= <sqf>if (lightIsOn nearestObject [player, "StreetLamp"] == "ON") then { hint "nightime"; };</sqf>
<dt class="note">'''[[User:Hardrock|hardrock]]'''<dd class="note">''Notes from before the conversion:''


Use [[switchLight]] to turn lamposts on and off.
|x2= <sqf>_it = lightIsOn object 159582;</sqf>


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


<!-- Note Section END -->
|seealso= [[switchLight]]
</dl>
}}
 
<h3 style="display:none">Bottom Section</h3>
 
[[Category:Scripting Commands|LIGHTISON]]
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.96|LIGHTISON]]
[[Category:Scripting Commands OFP 1.46|LIGHTISON]]
[[Category:Scripting Commands ArmA|LIGHTISON]]
[[Category:Command_Group:_Object_Information|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]

Latest revision as of 11:34, 3 September 2024

Logo A0.png1.04ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
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
Retrieved from "https://community.bistudio.com/wiki?title=lightIsOn&oldid=369182"