lockCameraTo: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " \| (\[\[[a-zA-Z ]+\]\]) \|x1=" to " |r1=$1 |x1=")
m (Add lockedCameraTo seeAlso link)
 
(27 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma3
|game1= arma3
|version1= 1.26


|1.26
|arg= local


|gr1= Camera Control
|gr1= Camera Control


| Lock/Unlock stabilized camera (in vanilla used currently only for UAVs) to target.
|descr= Lock/Unlock stabilized camera to target. Works only on turrets which have optic mode selected with [[directionStabilizationEnabled|direction stabilization enabled]].


| vehicle [[lockCameraTo]] [target, turretPath]
{{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 [[PositionASL]] - use [[objNull]] for unlocking
|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


|r1=[[Nothing]]
|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


|x1= <code>uav [[lockCameraTo]] [vehicle, [0,0]];</code>
|p22= target: [[Object]] or [[Array]] format [[Position#PositionASL|PositionASL]] - use [[objNull]] to unlock


|x2= <code>uav [[lockCameraTo]] [<nowiki/>[[objNull]], [0,0]]; {{cc|unlocks the turret}}</code>
|p23= turretPath: [[Array]] - path to the turret with required camera


|seealso= [[camTarget]] [[camSetTarget]] [[camPrepareTarget]]
|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.
 
|r2= [[Nothing]]
 
{{Feature|informative|This syntax also works with non-stabilised turrets, unlike {{Link|#Syntax 1}}.}}
 
|x1= <sqf>uav lockCameraTo [vehicle, [0,0]];</sqf>
 
|x2= <sqf>uav lockCameraTo [objNull, [0,0]]; // unlocks the turret</sqf>
 
|x3= <sqf>vehicle player lockCameraTo [enemyTarget, vehicle player unitTurret player, false];</sqf>
 
|seealso= [[lockedCameraTo]] [[camTarget]] [[camSetTarget]] [[camPrepareTarget]] [[directionStabilizationEnabled]] [[enableDirectionStabilization]]
}}
}}


<dl class="command_description">
{{Note
<dt><dt>
|user= Commy2
<dd class="notedate">Posted on April 10, 2015 - 06:54 (UTC)</dd>
|timestamp= 20150410065400
<dt class="note">[[User:Commy2|Commy2]]</dt>
|text= The vehicle has to have a stabilized optic for this command to work with ASL position.
<dd class="note">
}}
The vehicle has to have a stabilized optic for this command to work with ASL position.
</dd>
 
</dl>

Latest revision as of 23:57, 29 March 2023

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.