BIS fnc establishingShot: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (formatted example and added a new one which uses all parameters)
m (Text replacement - "(Optional, default {{hl|[]}})" to "(Optional, default <sqf inline>[]</sqf>)")
 
(52 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Function|Comments=
{{RV|type=function
____________________________________________________________________________________________


| arma3 |Game name=
|game1= arma3
|version1= 1.00


|1.00|Game version=
|gr1= GUI


|arg= global |MParg= Arguments in MP
|arg= global


|eff= local |MPEffects=
|eff= local
____________________________________________________________________________________________


| Play a fake UAV observational sequence which serves as an establishing shot. [[File:BIS fnc establishingShot.gif|left|400px]] |DESCRIPTION=
|descr= Plays a fake UAV observational sequence which serves as an establishing shot.<br> [[File:BIS_fnc_establishingShot.gif|left|400px]]
____________________________________________________________________________________________


| [target, text, altitude, radius, angle, rotation, iconOptions, mode, fadeIn,waitTime] spawn [[BIS_fnc_establishingShot]] |SYNTAX=
|s1= [target, text, altitude, radius, angle, rotation, iconOptions, mode, fadeIn, waitTime] spawn [[BIS_fnc_establishingShot]]


|p1= target: [[Object]] or [[Array]] - Target or target's position |PARAMETER1=
|p1= target: [[Object]] or [[Array]] - target or target's position
|p2= text: [[String]] - Text to display |PARAMETER2=
|p3= altitude: [[Number]] - (optional) Altitude (in meters) |PARAMETER3=
|p4= radius: [[Number]] - (optional) Radius of the circular movement (in meters) |PARAMETER4=
|p5= angle: [[Number]] - Viewing angle (in degrees) |PARAMETER5=
|p6= rotation: [[Number]] - Direction of camera movement (0: anti-clockwise, 1: clockwise, default: random) |PARAMETER6=
|p7= iconOptions: [[Array]] - Each array in format:
*0: icon: [[String]] - Path to icon texture
*1: color: [[Array]] - Color in format [R,G,B,A]
*2: target: [[Object]], [[Position]] or [[Group]] - Where the texture should be drawn
*3: sizeX: [[Number]] - Size of icon in x (Optional, default 1)
*4: sizeY: [[Number]] Size of icon in y (Optional, default 1)
*5: angle: [[Number]] - Angle of icon (Optional, default [[random]] 360)
*6: text: [[String]] - Text displayed underneath the icon (Optional, default "")
*7: shadow: [[Number]] - 0 to draw now shadow, 1 to draw a shadow (Optional, default 0)
|PARAMETER7=
|p8= mode: [[Number]] - 0: normal (default), 1: world scenes |PARAMETER8=
|p9= fadeIn: [[Boolean]] - Fade in after completion (default: true) |PARAMETER9=
|p10= waitTime: [[Number]] - Wait time in seconds after the shot has been completed (Since Arma 3 1.81) |PARAMETER10=


| [[Boolean]] - true when done |RETURNVALUE=
|p2= text: [[String]] - (Optional, default "") text to display
____________________________________________________________________________________________


|x1= <code><nowiki>[</nowiki>[[player]], "I can see my house from here", 500, 250, 75, 1, [], 0, [[true]]] [[spawn]] [[BIS_fnc_establishingShot]]</code> |=
|p3= altitude: [[Number]] - (Optional, default 500) altitude in meters


|x2= <code>[
|p4= radius: [[Number]] - (Optional, default 200) radius of the circular movement in meters
  [5229.97,5233.07,0],
  "BLUFOR and OPFOR firefight",
  500,
  250,
  75,
  1,
  [
    ["\A3\ui_f\data\map\markers\nato\b_inf.paa",[0,0.3,0.6,1],group_1,1,1,0,"BLUFOR"],
    ["\A3\ui_f\data\map\markers\nato\o_inf.paa",[0.5,0,0,1],group_2,1,1,0,"OPFOR"]
  ],
  0,
  [[true]],
  15
] [[spawn]] [[BIS_fnc_establishingShot]];</code> |=


____________________________________________________________________________________________
|p5= angle: [[Number]] - (Optional, default random) viewing angle in degrees


|exec= spawn |Execution=
|p6= rotation: [[Number]] - (Optional, default random) direction of camera movement
____________________________________________________________________________________________
* 0: anti-clockwise
* 1: clockwise


| [[BIS_fnc_dynamicText]], [[:Category:Function Group: GUI|GUI functions]] |SEEALSO=
|p7= iconOptions: [[Array]] of [[Array]]s - (Optional, default <sqf inline>[]</sqf>) each array in format [icon, color, target, sizeX, sizeY, angle, text, shadow]:
}}
* icon: [[String]] - path to icon texture
* color: [[Array]] format [[Color|Color (RGBA)]]
* target: [[Object]], [[Position]] or [[Group]] - where the texture should be drawn
* sizeX: [[Number]] - (Optional, default 1) icon width
* sizeY: [[Number]] - (Optional, default 1) icon height
* angle: [[Number]] - (Optional, default [[random]] 360) icon angle
* text: [[String]] - (Optional, default "") text displayed underneath the icon
* shadow: [[Number]] - (Optional, default 0)
** 0 to draw a flat icon
** 1 to draw a shadowed icon
 
|p8= mode: [[Number]] - (Optional, default 0)
* 0: normal (disables saving and sets {{hl|BIS_missionStarted}} to [[nil]])
* 1: world scenes
 
|p9= fadeIn: [[Boolean]] - (Optional, default [[true]]) fade in after completion


<h3 style="display:none">Notes</h3>
|p10= waitTime: [[Number]] - (Optional, default 2) wait time in seconds after the shot has been completed
<dl class="command_description">
|p10since= arma3 1.82
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|r1= [[Boolean]] - true when done
</dl>


<h3 style="display:none">Bottom Section</h3>
|x1= <sqf>[player, "I can see my house from here", 500, 250, 75, 1, [], 0, true] spawn BIS_fnc_establishingShot;</sqf>
[[Category:Function Group: GUI|{{uc:establishingShot}}]]
[[Category:Functions|{{uc:establishingShot}}]]
[[Category:{{Name|arma3}}: Functions|{{uc:establishingShot}}]]


<!-- CONTINUE Notes -->
|x2= <sqf>
[
[5229.97, 5233.07, 0],
"BLUFOR and OPFOR firefight",
500,
250,
75,
1,
[
["\A3\ui_f\data\map\markers\nato\b_inf.paa", [0, 0.3, 0.6, 1], group_1, 1, 1, 0, "BLUFOR"],
["\A3\ui_f\data\map\markers\nato\o_inf.paa", [0.5, 0, 0, 1], group_2, 1, 1, 0, "OPFOR"]
],
0,
true,
15
] spawn BIS_fnc_establishingShot;
</sqf>


<!-- DISCONTINUE Notes -->
|exec= spawn


<!-- CONTINUE Notes -->
|seealso= [[BIS_fnc_dynamicText]] [[Arma 3: Mission Presentation]]
<dl class="command_description">
}}
<dd class="notedate">Posted on January 28, 2018 - 02:01 (UTC)</dd>
 
<dt class="note">[[User:Lou Montana|Lou Montana]]</dt>
{{Note
<dd class="note">
|user= Lou Montana
Be aware that [[spawn]]ing this function will set [[enableSaving]] to true. Quick workaround:
|timestamp= 20180128020100
<code>_savingEnabled = [[savingEnabled]];
|text= Be aware that [[spawn]]ing this function will set [[enableSaving]] to true. Quick workaround:
_handle = [player, "myText"] [[spawn]] [[BIS_fnc_establishingShot]];
<sqf>
[[waitUntil]] { [[scriptDone]] _handle };
private _savingEnabled = savingEnabled;
[[enableSaving]] [_savingEnabled, false];</code>
_handle = [player, "myText"] spawn BIS_fnc_establishingShot;
waitUntil { scriptDone _handle };
enableSaving [_savingEnabled, false];
</sqf>


Or, if you can't wait the end of the establishing shot:
Or, if you can't wait the end of the establishing shot:
<code>_savingEnabled = [[savingEnabled]];
<sqf>private _savingEnabled = savingEnabled;
_handle = [player, "myText"] [[spawn]] [[BIS_fnc_establishingShot]];
_handle = [player, "myText"] spawn BIS_fnc_establishingShot;
_handle [[spawn]] { [[waitUntil]] { [[scriptDone]] _this }; [[enableSaving]] [_savingEnabled, false]; };</code>
_handle spawn { waitUntil { scriptDone _this }; enableSaving [_savingEnabled, false]; };</sqf>
</dd>
}}


<dd class="notedate">Posted on July 30, 2019 - 12:01 (UTC)</dd>
{{Note
<dt class="note">[[User:R3vo|R3vo]]</dt>
|user= R3vo
<dd class="note">
|timestamp= 20190730120100
In order to change the camera to TI or NVG mode execute the following right after [[BIS_fnc_establishingShot]] was spawned.
|text= In order to change the camera to TI or NVG mode execute the following right after [[BIS_fnc_establishingShot]] was spawned.
<code>[[true]] [[setCamUseTI]] 1;</code>
<sqf>true setCamUseTI 1;</sqf>
The effect will automatically be terminated once the establishing shot ended.
The effect will automatically be terminated once the establishing shot ended.
</dd>
}}
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 18:09, 8 November 2023

Arma 3 logo black.png1.00
GAGlobalLELocal
Hover & click on the images for description

Description

Description:
Plays a fake UAV observational sequence which serves as an establishing shot.
BIS fnc establishingShot.gif
Execution:
spawn
Groups:
GUI

Syntax

Syntax:
[target, text, altitude, radius, angle, rotation, iconOptions, mode, fadeIn, waitTime] spawn BIS_fnc_establishingShot
Parameters:
target: Object or Array - target or target's position
text: String - (Optional, default "") text to display
altitude: Number - (Optional, default 500) altitude in meters
radius: Number - (Optional, default 200) radius of the circular movement in meters
angle: Number - (Optional, default random) viewing angle in degrees
rotation: Number - (Optional, default random) direction of camera movement
  • 0: anti-clockwise
  • 1: clockwise
iconOptions: Array of Arrays - (Optional, default []) each array in format [icon, color, target, sizeX, sizeY, angle, text, shadow]:
  • icon: String - path to icon texture
  • color: Array format Color (RGBA)
  • target: Object, Position or Group - where the texture should be drawn
  • sizeX: Number - (Optional, default 1) icon width
  • sizeY: Number - (Optional, default 1) icon height
  • angle: Number - (Optional, default random 360) icon angle
  • text: String - (Optional, default "") text displayed underneath the icon
  • shadow: Number - (Optional, default 0)
    • 0 to draw a flat icon
    • 1 to draw a shadowed icon
mode: Number - (Optional, default 0)
  • 0: normal (disables saving and sets BIS_missionStarted to nil)
  • 1: world scenes
fadeIn: Boolean - (Optional, default true) fade in after completion
since Arma 3 logo black.png1.82
waitTime: Number - (Optional, default 2) wait time in seconds after the shot has been completed
Return Value:
Boolean - true when done

Examples

Example 1:
[player, "I can see my house from here", 500, 250, 75, 1, [], 0, true] spawn BIS_fnc_establishingShot;
Example 2:
[ [5229.97, 5233.07, 0], "BLUFOR and OPFOR firefight", 500, 250, 75, 1, [ ["\A3\ui_f\data\map\markers\nato\b_inf.paa", [0, 0.3, 0.6, 1], group_1, 1, 1, 0, "BLUFOR"], ["\A3\ui_f\data\map\markers\nato\o_inf.paa", [0.5, 0, 0, 1], group_2, 1, 1, 0, "OPFOR"] ], 0, true, 15 ] spawn BIS_fnc_establishingShot;

Additional Information

See also:
BIS_fnc_dynamicText Arma 3: Mission Presentation

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
Lou Montana - c
Posted on Jan 28, 2018 - 02:01 (UTC)
Be aware that spawning this function will set enableSaving to true. Quick workaround:
private _savingEnabled = savingEnabled; _handle = [player, "myText"] spawn BIS_fnc_establishingShot; waitUntil { scriptDone _handle }; enableSaving [_savingEnabled, false];
Or, if you can't wait the end of the establishing shot:
private _savingEnabled = savingEnabled; _handle = [player, "myText"] spawn BIS_fnc_establishingShot; _handle spawn { waitUntil { scriptDone _this }; enableSaving [_savingEnabled, false]; };
R3vo - c
Posted on Jul 30, 2019 - 12:01 (UTC)
In order to change the camera to TI or NVG mode execute the following right after BIS_fnc_establishingShot was spawned.
true setCamUseTI 1;
The effect will automatically be terminated once the establishing shot ended.
Retrieved from "https://community.bistudio.com/wiki?title=BIS_fnc_establishingShot&oldid=349481"