switchCamera: Difference between revisions

Latest revision as of 13:56, 27 October 2025

1.00

1.50

1.00

0.50

Hover & click on the images for description

Description

Description:

Switch camera to given vehicle / camera. Mode is one of:

"INTERNAL": 1st person
"GUNNER": optics / sights
"EXTERNAL": 3rd person (inaccessible if difficulty settings do not allow for it)
"GROUP": group
"CARGO": same as "INTERNAL"

If you switch to a unit in a vehicle, this command uses the correct turret.

⚠

Control over the unit is not given to the player. Use selectPlayer or a combination of switchCamera and remoteControl to achieve this.
Always switchCamera first (when needed) before using remoteControl as doing it after may lead to unpredictable results.

Groups:

Camera Control

Syntax

Syntax:: target switchCamera mode
Parameters:: target: Object
: mode: String
Return Value:: Nothing

1.66

Alternative Syntax

Syntax:: switchCamera target
Parameters:: target: Object
Return Value:: Nothing

Examples

Example 1:: player switchCamera "Gunner";
Example 2:: vehicle player switchCamera "External";

Additional Information

See also:: cameraView cameraOn cameraEffect selectPlayer remoteControl

Notes

: Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord.
Only post proven facts here! Add Note

Killzone_Kid - c: Posted on May 16, 2015 - 13:14 (UTC)
: Force top down view:
private _cameraObject = "Land_HandyCam_F" createVehicleLocal [0, 0, 0]; _cameraObject hideObject true; _cameraObject attachTo [player, [0, 0, 10]]; _cameraObject setVectorUp [0, 0.99, 0.01]; _cameraObject switchCamera "Internal"; findDisplay 46 displayAddEventHandler ["MouseButtonDown", { if (_this select 1 == 0) then { player forceWeaponFire [currentMuzzle player, currentWeaponMode player]; }; false; }]; findDisplay 46 displayAddEventHandler ["KeyDown", { if (_this select 1 in actionKeys "ReloadMagazine") then { reload player; }; false; }];

@@ Line 1: / Line 1: @@
-back to [[Scripting_Reference#S|COMREF]]
+{{RV|type=command
-<h2 style="color:#000066">'''''unit ''switchCamera ''mode'''''</h2>
+|game1= ofp
+|version1= 1.00
-'''Operand types:'''
+|game2= ofpe
+|version2= 1.00
-'''unit:''' [[Object]]
+|game3= arma1
+|version3= 1.00
-'''mode:''' [[String]]
+|game4= arma2
+|version4= 1.00
-'''Type of returned value:'''
+|game5= arma2oa
+|version5= 1.50
-[[Nothing]]
+|game6= tkoh
+|version6= 1.00
-'''Description:'''
+|game7= arma3
+|version7= 0.50
-Switch camera to given '''vehicle / camera'''.
+|gr1= Camera Control
-'''Mode''' is one of:
+|descr= Switch camera to given vehicle / camera. Mode is one of:
+* '''"INTERNAL"''': 1st person
+* '''"GUNNER"''': optics / sights
+* '''"EXTERNAL"''': 3rd person (inaccessible if difficulty settings do not allow for it)
+* '''"GROUP"''': group
+* '''"CARGO"''': same as "INTERNAL"
-* '''"INTERNAL"''' (1st person)
+If you switch to a unit in a vehicle, this command uses the correct turret.
-* '''"GUNNER"''' (optics / sights)
+{{Feature|important|
-* '''"EXTERNAL"''' (3rd person)
+* Control over the unit is not given to the player. Use [[selectPlayer]] or a combination of [[switchCamera]] and [[remoteControl]] to achieve this.
-* '''"GROUP"''' (group)
+* Always [[switchCamera]] first (when needed) '''before''' using [[remoteControl]] as doing it after may lead to unpredictable results.
+}}
+|s1= target [[switchCamera]] mode
-'''Example:'''
+|p1= target: [[Object]]
-loon1 '''switchCamera''' '''"External"'''
+|p2= mode: [[String]]
+|r1= [[Nothing]]
-'''Comments''
+|s2= [[switchCamera]] target
-If you [[switchCamera]] to a group leader, you can control his group as if it were your own.
+|s2since= arma3 1.66
+|p21= target: [[Object]]
+|r2= [[Nothing]]
+|x1= <sqf>player switchCamera "Gunner";</sqf>
+|x2= <sqf>vehicle player switchCamera "External";</sqf>
+|seealso= [[cameraView]] [[cameraOn]] [[cameraEffect]] [[selectPlayer]] [[remoteControl]]
+}}
+{{Note
+|user= Killzone_Kid
+|timestamp= 20150516131400
+|text=  Force top down view:
+<sqf>
+private _cameraObject = "Land_HandyCam_F" createVehicleLocal [0, 0, 0];
+_cameraObject hideObject true;
+_cameraObject attachTo [player, [0, 0, 10]];
+_cameraObject setVectorUp [0, 0.99, 0.01];
+_cameraObject switchCamera "Internal";
+findDisplay 46 displayAddEventHandler ["MouseButtonDown", {
+	if (_this select 1 == 0) then
+	{
+		player forceWeaponFire [currentMuzzle player, currentWeaponMode player];
+	};
+	false;
+}];
+findDisplay 46 displayAddEventHandler ["KeyDown", {
+	if (_this select 1 in actionKeys "ReloadMagazine") then
+	{
+		reload player;
+	};
+	false;
+}];
+</sqf>
+}}