{"name":"getLighting","operator":null,"title":"getLighting","type":"command","url":"https://community.bistudio.com/wiki/getLighting","revid":377678,"updated":"2026-01-02T09:02:42Z","groups":["Lights"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"2.00"}],"since":{"game":"arma3","name":"Arma 3","version":"2.00"},"arma3_since":"2.00","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Gets general environment's light settings.","syntaxes":[{"syntax":"getLighting","since":null,"effect":null,"exec":null,"params":[],"returns":{"type":"Array with [ambientLightColor, ambientLightBrightness, lightDirection, starsVisibility]","types":["Array"],"description":"ambientLightColor: Color (RGB) - ambientLightBrightness: Number - lightDirection: Vector3D - starsVisibility: Number","text":"Array with [ambientLightColor, ambientLightBrightness, lightDirection, starsVisibility]\n- ambientLightColor: Color (RGB)\n- ambientLightBrightness: Number\n- lightDirection: Vector3D\n- starsVisibility: Number"},"form":"nullary","operator":null,"left":null,"right":null}],"examples":[{"text":"```sqf\ngetLighting; // returns [[0.646753,0.781818,1],28526.2,[-0.0167152,0.211598,-0.977214],0]\n```","code":["getLighting; // returns [[0.646753,0.781818,1],28526.2,[-0.0167152,0.211598,-0.977214],0]"]},{"text":"```sqf\ngetLighting params [\"_ambientLightColour\", \"_ambientLightBrightness\", \"_lightDirection\", \"_starsVisibility\"];\n```","code":["getLighting params [\"_ambientLightColour\", \"_ambientLightBrightness\", \"_lightDirection\", \"_starsVisibility\"];"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["getLightingAt","moonPhase","Light Source Tutorial"],"notes":[{"user":"POLPOX","date":"2023-09-18T13:20:29Z","text":"Possible to check if a position is in a shadow.\n\n```sqf\n[player,\"VIEW\"] checkVisibility [eyePos player,eyePos player vectorDiff ((getLighting#2) vectorMultiply 200)]\n```"}],"categories":["Arma 3: New Scripting Commands","Arma 3: Scripting Commands","Command Group: Lights","Introduced with Arma 3 version 2.00","Scripting Commands"]}