lockCameraTo: Difference between revisions

From Bohemia Interactive Community
(Add 2.08 syntax)
mNo edit summary
 
(20 intermediate revisions by 4 users not shown)
Line 3: Line 3:
|game1= arma3
|game1= arma3
|version1= 1.26
|version1= 1.26
|arg= local


|gr1= Camera Control
|gr1= Camera Control
Line 8: Line 10:
|descr= Lock/Unlock stabilized camera to target. Works only on turrets which have optic mode selected with [[directionStabilizationEnabled|direction stabilization enabled]].
|descr= Lock/Unlock stabilized camera to target. Works only on turrets which have optic mode selected with [[directionStabilizationEnabled|direction stabilization enabled]].


|s1= vehicle [[lockCameraTo]] [target, turretPath, temporary]
{{Feature|informative|Since {{GVI|arma3|2.08}} the command also works with non-stabilized turrets (such as main turret of a tank). See {{Link|#Alternative_Syntax|syntax 2}}.}}
 
{{Feature|informative|The command is local to the '''turret''' gunner, not the vehicle.}}
 
|s1= vehicle [[lockCameraTo]] [target, turretPath]


|p1= vehicle: [[Object]] - UAV
|p1= vehicle: [[Object]] - UAV


|p2= target: [[Object]] or [[Position#PositionASL|PositionASL]] - use [[objNull]] to unlock
|p2= target: [[Object]] or [[Array]] format [[Position#PositionASL|PositionASL]] - use [[objNull]] to unlock


|p3= turretPath: [[Array]] - path to the turret with required camera
|p3= turretPath: [[Array]] - path to the turret with required camera


|p4= temporary: [[Boolean]] - (Optional, default [[false]]) if set, the syntax also works with non-stabilised turrets.<br>
|r1= [[Nothing]]
If set to [[true]], the engine will automatically remove the lock-on once the turret reaches its target.
If the target is out of turret's reach, the turret will move to the maximum of its capacity towards the target.
{{Feature|important|If ''temporary'' is '''not''' set and target is out of possible view, the turret will move to its limit and get stuck there, with blocked input.}}
|p4since= arma3 2.08


|r1= [[Nothing]]
{{Feature|important|
* This syntax only works with stabilized turrets.
* When using this syntax, if target is out of possible view, the turret will move to its limit and get stuck there, with blocked input.
}}
 
|s2= vehicle [[lockCameraTo]] [target, turretPath, temporary]
 
|s2since= arma3 2.08
 
|p21= vehicle: [[Object]] - UAV
 
|p22= target: [[Object]] or [[Array]] format [[Position#PositionASL|PositionASL]] - use [[objNull]] to unlock
 
|p23= turretPath: [[Array]] - path to the turret with required camera
 
|p24= temporary: [[Boolean]] - if set to [[true]], the engine will automatically remove the lock-on once the turret reaches its target.
If the target is out of turret's reach, once the turret reaches its [[getTurretLimits | limits]] the lock-on will be released.
 
|r2= [[Nothing]]
 
{{Feature|informative|This syntax also works with non-stabilized turrets, unlike {{Link|#Syntax 1}}.}}


|x1= <code>uav [[lockCameraTo]] [vehicle, [0,0]];</code>
|x1= <sqf>uav lockCameraTo [cursorObject, [0,0]];</sqf>


|x2= <code>uav [[lockCameraTo]] [<nowiki/>[[objNull]], [0,0]]; {{cc|unlocks the turret}}</code>
|x2= <sqf>uav lockCameraTo [objNull, [0,0]]; // unlocks the turret</sqf>


|x3= <code>[[vehicle]] [[player]] [[lockCameraTo]] [enemyTarget, [[vehicle]] [[player]] [[unitTurret]] [[player]], [[false]]];</code>
|x3= <sqf>vehicle player lockCameraTo [enemyTarget, vehicle player unitTurret player, false];</sqf>


|seealso= [[camTarget]] [[camSetTarget]] [[camPrepareTarget]] [[directionStabilizationEnabled]] [[enableDirectionStabilization]]
|seealso= [[lockedCameraTo]] [[camTarget]] [[camSetTarget]] [[camPrepareTarget]] [[directionStabilizationEnabled]] [[enableDirectionStabilization]]
}}
}}


Latest revision as of 03:07, 21 October 2025

Arma 3 logo black.png 1.26
LALocal
Hover & click on the images for description

Description

Description:
Lock/Unlock stabilized camera to target. Works only on turrets which have optic mode selected with direction stabilization enabled.
ⓘ
Since Arma 3 logo black.png 2.08 the command also works with non-stabilized turrets (such as main turret of a tank). See syntax 2.
ⓘ
The command is local to the turret gunner, not the vehicle.
Groups:
Camera Control

Syntax

Syntax:
vehicle lockCameraTo [target, turretPath]
Parameters:
vehicle: Object - UAV
target: Object or Array format PositionASL - use objNull to unlock
turretPath: Array - path to the turret with required camera
Return Value:
Nothing
⚠
  • This syntax only works with stabilized turrets.
  • When using this syntax, if target is out of possible view, the turret will move to its limit and get stuck there, with blocked input.

Alternative Syntax

Syntax:
vehicle lockCameraTo [target, turretPath, temporary]
Parameters:
vehicle: Object - UAV
target: Object or Array format PositionASL - use objNull to unlock
turretPath: Array - path to the turret with required camera
temporary: Boolean - if set to true, the engine will automatically remove the lock-on once the turret reaches its target. If the target is out of turret's reach, once the turret reaches its limits the lock-on will be released.
Return Value:
Nothing
ⓘ
This syntax also works with non-stabilized turrets, unlike Syntax 1.

Examples

Example 1:
uav lockCameraTo [cursorObject, [0,0]];
Example 2:
uav lockCameraTo [objNull, [0,0]]; // unlocks the turret
Example 3:
vehicle player lockCameraTo [enemyTarget, vehicle player unitTurret player, false];

Additional Information

See also:
lockedCameraTo camTarget camSetTarget camPrepareTarget directionStabilizationEnabled enableDirectionStabilization

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
Commy2 - c
Posted on Apr 10, 2015 - 06:54 (UTC)
The vehicle has to have a stabilized optic for this command to work with ASL position.
Retrieved from "https://community.bistudio.com/wiki?title=lockCameraTo&oldid=376483"