setViewDistance: Difference between revisions

Latest revision as of 18:28, 25 May 2024

1.00

Hover & click on the images for description

Description

Description:

Set rendering distance. Setting view distance to <= 0 resets the value to the client's options (set in Options → Video → General → Visibility → Overall).

ⓘ

In previous versions, client's max view distance was limited by the server's view distance.

⚠

View distance also defines the maximum distance between a unit and any other unit they can know about. Higher view distance will involve more AI simulation cycles for every unit, which causes low performance. See Arma 3: Performance Optimisation.

Game	min. scripted	min. UI	default	max. UI	max. scripted
Arma 3	200	500	1600	12000	40000
Arma 2: Operation Arrowhead	200	500	2500	10000	15000
Arma 2	200	500	3000	10000	15000
Armed Assault	200	500	1200	10000	15000
Operation Flashpoint	500	500	900	5000	5000

Groups:

System Environment

Syntax

Syntax:: setViewDistance distance
Parameters:: distance: Number - distance in metres; 1.00 a negative value resets the view distance to user video setting
Return Value:: Nothing

Examples

Example 1:: setViewDistance 2250;
Example 2:: setViewDistance -1; // reset view distance in Arma 3

Additional Information

See also:: viewDistance setDetailMapBlendPars setTerrainGrid getObjectViewDistance setObjectViewDistance

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

@@ Line 1: / Line 1: @@
-{{Command
+{{RV|type=command
-| ofp
+|game1= ofp
+|version1= 1.00
-|1.00
+|game2= ofpe
+|version2= 1.00
+|game3= arma1
+|version3= 1.00
+|game4= arma2
+|version4= 1.00
+|game5= arma2oa
+|version5= 1.50
+|game6= tkoh
+|version6= 1.00
+|game7= arma3
+|version7= 0.50
 |eff= local
@@ Line 11: / Line 28: @@
 |gr2= Environment
-| Set rendering distance. Setting view distance to &lt;{{=}} 0 resets the value to the client's options (set in <tt>Options → Video → General → Visibility → Overall</tt>).
+|descr= Set rendering distance. Setting view distance to <= 0 resets the value to the client's options (set in {{hl|Options → Video → General → Visibility → Overall}}).
-{{Informative|Client-side max view distance is limited by the server's view distance.}}
+{{Feature|informative|In previous versions, client's max view distance was limited by the server's view distance.}}
-{{Important|View distance also defines the maximum distance between a unit and any other unit they can [[knowsAbout|know about]].
+{{Feature|important|
-Higher view distance will involve more AI simulation cycles for every unit, which causes low performance.}}
+View distance also defines the maximum distance between a unit and any other unit they can [[knowsAbout|know about]].
+Higher view distance will involve more AI simulation cycles for every unit, which causes low performance. See [[Arma 3: Performance Optimisation]].
+}}
-{{{!}}class{{=}}"wikitable"
+{{{!}} class="wikitable"
-!Game
+! Game
-!min. scripted
+! min. scripted
-!min. UI
+! min. UI
-!default
+! default
-!max. UI
+! max. UI
-!max. scripted
+! max. scripted
 {{!}}-
-{{!}}{{arma3}}
+{{!}} {{arma3}}
-{{!}}200
+{{!}} 200
-{{!}}500
+{{!}} 500
-{{!}}'''1600'''
+{{!}} '''1600'''
-{{!}}12000
+{{!}} 12000
-{{!}}40000
+{{!}} 40000
 {{!}}-
-{{!}}{{arma2oa}}
+{{!}} {{arma2oa}}
-{{!}}200
+{{!}} 200
-{{!}}500
+{{!}} 500
-{{!}}'''2500'''
+{{!}} '''2500'''
-{{!}}10000
+{{!}} 10000
-{{!}}15000
+{{!}} 15000
 {{!}}-
-{{!}}{{arma2}}
+{{!}} {{arma2}}
-{{!}}200
+{{!}} 200
-{{!}}500
+{{!}} 500
-{{!}}'''3000'''
+{{!}} '''3000'''
-{{!}}10000
+{{!}} 10000
-{{!}}15000
+{{!}} 15000
 {{!}}-
-{{!}}{{arma1}}
+{{!}} {{arma1}}
-{{!}}200
+{{!}} 200
-{{!}}500
+{{!}} 500
-{{!}}'''1200'''
+{{!}} '''1200'''
-{{!}}10000
+{{!}} 10000
-{{!}}?
+{{!}} 15000
 {{!}}-
-{{!}}{{ofp}}
+{{!}} {{ofp}}
-{{!}}500
+{{!}} 500
-{{!}}500
+{{!}} 500
-{{!}}'''900'''
+{{!}} '''900'''
-{{!}}5000
+{{!}} 5000
-{{!}}?
+{{!}} 5000
 {{!}}}
-| [[setViewDistance]] distance
+|s1= [[setViewDistance]] distance
+|p1= distance: [[Number]] - distance in metres; {{GVI|arma3|1.00|size= 0.75}} a negative value resets the view distance to user video setting
-|p1= distance: [[Number]] - distance in metres
+|r1= [[Nothing]]
-| [[Nothing]]
+|x1= <sqf>setViewDistance 2250;</sqf>
-|x1= <code>[[setViewDistance]] 2250;</code>
-|x2= <code>[[setViewDistance]] -1; {{codecomment|// reset view distance in {{arma3}}}}</code>
+|x2= <sqf>setViewDistance -1; // reset view distance in Arma 3</sqf>
-| [[viewDistance]], [[setDetailMapBlendPars]], [[setTerrainGrid]], [[getObjectViewDistance]], [[setObjectViewDistance]]
+|seealso= [[viewDistance]] [[setDetailMapBlendPars]] [[setTerrainGrid]] [[getObjectViewDistance]] [[setObjectViewDistance]]
 }}
-<dl class="command_description">
-</dl>
-[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands OFP 1.46|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
-{{GameCategory|arma1|Scripting Commands}}
-{{GameCategory|arma2|Scripting Commands}}
-{{GameCategory|arma3|Scripting Commands}}
-{{GameCategory|tkoh|Scripting Commands}}