lockCameraTo: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Add 2.08 syntax)
m (Add lockedCameraTo seeAlso link)
 
(17 intermediate revisions by 2 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.
 
{{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, the turret will move to the maximum of its capacity towards the 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]]
|r2= [[Nothing]]
 
{{Feature|informative|This syntax also works with non-stabilised turrets, unlike {{Link|#Syntax 1}}.}}


|x1= <code>uav [[lockCameraTo]] [vehicle, [0,0]];</code>
|x1= <sqf>uav lockCameraTo [vehicle, [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 22:57, 29 March 2023

Arma 3 logo black.png1.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.png2.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, the turret will move to the maximum of its capacity towards the target.
Return Value:
Nothing
ⓘ
This syntax also works with non-stabilised turrets, unlike Syntax 1.

Examples

Example 1:
uav lockCameraTo [vehicle, [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=338705"