lockCameraTo: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|Game version=" to "|Game version= |gr1 = Camera Control |GROUP1= ")
m (Add lockedCameraTo seeAlso link)
 
(41 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma3 |Game name=
|game1= arma3
|version1= 1.26


|1.26|Game version=
|arg= local


|gr1 = Camera Control |GROUP1=
|gr1= Camera Control


|descr= Lock/Unlock stabilized camera to target. Works only on turrets which have optic mode selected with [[directionStabilizationEnabled|direction stabilization enabled]].


{{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.}}


| Lock/Unlock stabilized camera (in vanilla used currently only for UAVs) to target. |DESCRIPTION=
|s1= vehicle [[lockCameraTo]] [target, turretPath]
____________________________________________________________________________________________


| vehicle [[lockCameraTo]] [target, turretPath] |SYNTAX=
|p1= vehicle: [[Object]] - UAV


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


|p2= target: [[Object]] or [[PositionASL]] - use [[objNull]] for unlocking |PARAMETER2=
|p3= turretPath: [[Array]] - path to the turret with required camera


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


| [[Nothing]] |RETURNVALUE=
{{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.
|x1= <code>uav [[lockCameraTo]] [vehicle, [0,0]];</code> |EXAMPLE1=
}}


|x2= <code>uav [[lockCameraTo]] [<nowiki/>[[objNull]], [0,0]]; {{cc|unlocks the turret}}</code> |EXAMPLE2=
|s2= vehicle [[lockCameraTo]] [target, turretPath, temporary]
____________________________________________________________________________________________


| |SEEALSO=
|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.
 
|r2= [[Nothing]]


<h3 style="display:none">Notes</h3>
{{Feature|informative|This syntax also works with non-stabilised turrets, unlike {{Link|#Syntax 1}}.}}
<dl class="command_description">
<!-- Note Section BEGIN -->


<dd class="notedate">Posted on April 10, 2015 - 06:54 (UTC)</dd>
|x1= <sqf>uav lockCameraTo [vehicle, [0,0]];</sqf>
<dt class="note">[[User:Commy2|Commy2]]</dt>
<dd class="note">
The vehicle has to have a stabilized optic for this command to work with ASL position.
</dd>


<!-- Note Section END -->
|x2= <sqf>uav lockCameraTo [objNull, [0,0]]; // unlocks the turret</sqf>
</dl>


<h3 style="display:none">Bottom Section</h3>
|x3= <sqf>vehicle player lockCameraTo [enemyTarget, vehicle player unitTurret player, false];</sqf>


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


[[Category:Command Group: Camera Control]]
{{Note
[[Category:Command Group: Remote Control]]
|user= Commy2
|timestamp= 20150410065400
|text= The vehicle has to have a stabilized optic for this command to work with ASL position.
}}

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"