ctrlSetAngle: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - " <!-- [A-Z]+ Notes? Section -->" to "") |
(merged syntaxes) |
||
Line 1: | Line 1: | ||
{{RV|type=command | {{RV|type=command | ||
| | |game1= arma3 | ||
| | |version1= 1.62 | ||
| | |arg= local | ||
| | |eff= local | ||
| | |gr1= GUI Control | ||
| | |descr= Sets the rotation of an <tt>ST_PICTURE</tt> control. Rotation will be done within the control boundaries, so if the X and Y are given off center, the picture may get clipped by the control boundaries. Only requires [[ctrlCommit]] when fourth parameter is set to [[false]]. Procedural textures filled controls do not rotate. | ||
| | |s1= control [[ctrlSetAngle]] [angle, centerX, centerY] | ||
| | |p1= control: [[Control]] - picture control | ||
| | |p2= angle: [[Number]] - Rotation angle (clockwise) | ||
| | |p3= centerX: [[Number]] - Rotation center X in range 0 to 1. Control center is 0.5 | ||
| | |p4= centerY: [[Number]] - Rotation center Y in range 0 to 1. Control center is 0.5 | ||
| | |p5= now: [[Boolean]] - (Optional, default [[true]]) If [[false]], control will wait for [[ctrlCommit]] input for result to apply | ||
| | |r1= [[Nothing]] | ||
|x1= <code>_control [[ctrlSetAngle]] [25, 0.5, 0.5];</code> | |x1= <code>_control [[ctrlSetAngle]] [25, 0.5, 0.5];</code> | ||
Line 63: | Line 52: | ||
|seealso= [[ctrlAngle]] | |seealso= [[ctrlAngle]] | ||
}} | }} | ||
Revision as of 09:24, 26 April 2021
Description
- Description:
- Sets the rotation of an ST_PICTURE control. Rotation will be done within the control boundaries, so if the X and Y are given off center, the picture may get clipped by the control boundaries. Only requires ctrlCommit when fourth parameter is set to false. Procedural textures filled controls do not rotate.
- Groups:
- GUI Control
Syntax
- Syntax:
- control ctrlSetAngle [angle, centerX, centerY]
- Parameters:
- control: Control - picture control
- angle: Number - Rotation angle (clockwise)
- centerX: Number - Rotation center X in range 0 to 1. Control center is 0.5
- centerY: Number - Rotation center Y in range 0 to 1. Control center is 0.5
- now: Boolean - (Optional, default true) If false, control will wait for ctrlCommit input for result to apply
- Return Value:
- Nothing
Examples
- Example 1:
_control ctrlSetAngle [25, 0.5, 0.5];
- Example 2:
with uiNamespace do { ctrl = findDisplay 46 ctrlCreate ["RscPictureKeepAspect", -1]; ctrl ctrlSetPosition [0,0,1,1]; ctrl ctrlSetText "A3\Missions_F_Exp\data\Img\lobby\ui_campaign_lobby_background_tablet_radial_left_ca.paa"; ctrl ctrlCommit 0; angle = 0; onEachFrame { with uiNamespace do { if (angle > 359) then {angle = 0}; ctrl ctrlSetAngle [angle, 0.5, 0.5]; angle = angle + 1; }; }; };
- Example 3:
_control ctrlSetAngle [25, 0.5, 0.5, false]; _control ctrlCommit 1; // Rotation applies smoothly for 1 second.
Additional Information
- See also:
- ctrlAngle
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