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: @@
-[[Category:Scripting Commands|SETVIEWDISTANCE]]
+{{RV|type=command
-[[Category:Scripting Commands OFP 1.96|SETVIEWDISTANCE]]
-[[Category:Scripting Commands OFP 1.46|SETVIEWDISTANCE]]
-[[Category:Scripting Commands ArmA|SETVIEWDISTANCE]]
+|game1= ofp
+|version1= 1.00
-<h2 style="color:#000066">'''setViewDistance ''distance'''''</h2>
+|game2= ofpe
+|version2= 1.00
+|game3= arma1
+|version3= 1.00
-'''Operand types:'''
+|game4= arma2
+|version4= 1.00
-'''distance:''' [[Number]]
+|game5= arma2oa
+|version5= 1.50
-'''Type of returned value:'''
+|game6= tkoh
+|version6= 1.00
-[[Nothing]]
+|game7= arma3
+|version7= 0.50
-'''Description:'''
+|eff= local
-Set rendering distance, in metres.
+|gr1= System
-Default is 900m, accepted range is 500m to 5000m.
+|gr2= Environment
+|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}}).
+{{Feature|informative|In previous versions, client's max view distance was limited by the server's view distance.}}
+{{Feature|important|
+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]].
+}}
-'''Example:'''
+{{{!}} class="wikitable"
+! Game
+! min. scripted
+! min. UI
+! default
+! max. UI
+! max. scripted
+{{!}}-
+{{!}} {{arma3}}
+{{!}} 200
+{{!}} 500
+{{!}} '''1600'''
+{{!}} 12000
+{{!}} 40000
+{{!}}-
+{{!}} {{arma2oa}}
+{{!}} 200
+{{!}} 500
+{{!}} '''2500'''
+{{!}} 10000
+{{!}} 15000
+{{!}}-
+{{!}} {{arma2}}
+{{!}} 200
+{{!}} 500
+{{!}} '''3000'''
+{{!}} 10000
+{{!}} 15000
+{{!}}-
+{{!}} {{arma1}}
+{{!}} 200
+{{!}} 500
+{{!}} '''1200'''
+{{!}} 10000
+{{!}} 15000
+{{!}}-
+{{!}} {{ofp}}
+{{!}} 500
+{{!}} 500
+{{!}} '''900'''
+{{!}} 5000
+{{!}} 5000
+{{!}}}
-'''setViewDistance''' 2250
+|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
+|r1= [[Nothing]]
+|x1= <sqf>setViewDistance 2250;</sqf>
+|x2= <sqf>setViewDistance -1; // reset view distance in Arma 3</sqf>
+|seealso= [[viewDistance]] [[setDetailMapBlendPars]] [[setTerrainGrid]] [[getObjectViewDistance]] [[setObjectViewDistance]]
+}}