setAperture: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|= Comments" to "|Comments=")
m (Some wiki formatting)
 
(44 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma |= Game name
|game1= arma1
|eff= local|Multiplayer Effects=
|version1= 1.00


|1.00|= Game version
|game2= arma2
____________________________________________________________________________________________
|version2= 1.00


| Sets custom camera aperture (-1 to do it automatically). |DESCRIPTION=
|game3= arma2oa
____________________________________________________________________________________________
|version3= 1.50


| '''setAperture''' aperture |SYNTAX=
|game4= tkoh
|version4= 1.00


|p1= aperture: [[Number]] |PARAMETER1=
|game5= arma3
|version5= 0.50


| [[Nothing]] |RETURNVALUE=
|eff= local
____________________________________________________________________________________________
 
|x1= <code>[[setAperture]] 0.3;</code> |EXAMPLE1=
____________________________________________________________________________________________


| [[setApertureNew]] |SEEALSO=
|gr1= Camera Control


|gr2= Lights
|descr= Sets custom eye accommodation camera aperture.
{{Feature|informative|
If HDR is enabled, when [[setAperture]] {{hl|value}} is used it also forces [[setApertureNew]] to the following values: [{{hl|value}}, {{hl|value}}, {{hl|value}}, 1].
Execute [[setApertureNew]] after [[setAperture]] to override this default mechanic.
}} 
{{Feature|important|
The aperture is set to default by the engine at the mission start. If you set it before the mission started it will reset like it never happened.
Make sure you set it at the right time (see {{Link|#Example 2}}).
}}
}}


<h3 style="display:none">Notes</h3>
|s1= [[setAperture]] aperture
<dl class="command_description">
 
<!-- Note Section BEGIN -->
|p1= aperture: [[Number]] - aperture value; a value {{hl|c= <= 0}} will set the aperture automatically. Maximum value which has an effect seems to be {{hl|100}}.
<dt class="note">[[User:Namikaze|Namikaze]]
 
<dd class="note">The aperture value to simulate typical daylight (outdoor) conditions is 50. The aperture value to simulate typical daylight (indoor) conditions is 30. Setting the value to less than 20 will result in a very bright scene, suitable for night conditions. The closer the number is to 0, the more light will be let into the lens, to carry on the aperture metaphor. Different lighting/weather conditions can change the actual indoor and outdoor aperture values.  Experiment and test to be sure.
|r1= [[Nothing]]
 
|x1= <sqf>setAperture 0.3;</sqf>
 
|x2= <sqf>0 spawn { sleep 0.1; setAperture 100 };</sqf>


<!-- Note Section END -->
|seealso= [[setApertureNew]] [[apertureParams]]
</dl>
}}


<h3 style="display:none">Bottom Section</h3>
{{Note
[[Category:Scripting Commands|SETAPERTURE]]
|user= Namikaze
[[Category:Scripting Commands OFP Elite |SETAPERTURE]]
|timestamp= 20090317194300
[[Category:Scripting Commands ArmA|SETAPERTURE]]
|text= The aperture value to simulate typical daylight (outdoor) conditions is 50. The aperture value to simulate typical daylight (indoor) conditions is 30.
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
Setting the value to less than 20 will result in a very bright scene, suitable for night conditions.
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
The closer the number is to 0, the more light will be let into the lens, to carry on the aperture metaphor.
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
Different lighting/weather conditions can change the actual indoor and outdoor aperture values. Experiment and test to be sure.
}}

Latest revision as of 18:05, 12 May 2023

Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
LELocal
Hover & click on the images for description

Description

Description:
Sets custom eye accommodation camera aperture.
ⓘ
If HDR is enabled, when setAperture value is used it also forces setApertureNew to the following values: [value, value, value, 1]. Execute setApertureNew after setAperture to override this default mechanic.
⚠
The aperture is set to default by the engine at the mission start. If you set it before the mission started it will reset like it never happened. Make sure you set it at the right time (see Example 2).
Groups:
Camera ControlLights

Syntax

Syntax:
setAperture aperture
Parameters:
aperture: Number - aperture value; a value <= 0 will set the aperture automatically. Maximum value which has an effect seems to be 100.
Return Value:
Nothing

Examples

Example 1:
setAperture 0.3;
Example 2:
0 spawn { sleep 0.1; setAperture 100 };

Additional Information

See also:
setApertureNew apertureParams

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
Namikaze - c
Posted on Mar 17, 2009 - 19:43 (UTC)
The aperture value to simulate typical daylight (outdoor) conditions is 50. The aperture value to simulate typical daylight (indoor) conditions is 30. Setting the value to less than 20 will result in a very bright scene, suitable for night conditions. The closer the number is to 0, the more light will be let into the lens, to carry on the aperture metaphor. Different lighting/weather conditions can change the actual indoor and outdoor aperture values. Experiment and test to be sure.
Retrieved from "https://community.bistudio.com/wiki?title=setAperture&oldid=340862"