Title Effect Type: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
No edit summary
(7 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Stub}}
A [[Title Effect Type]] is a [[String]] parameter that is required by a few scripting commands. The commands are used to display custom GUI elements on the front end or the back end. Six commands use this parameter:


A '''Title Effect Type''' is a [[String]] parameter that is required by a few scripting commands.  The commands are used to display custom GUI elements on the front end or the back end.  Currently, there are six commands in OFP/ArmA that use this parameter:
{|
|
{| style="min-width: 20em"
! cut* commands !! title* commands
|-
|
* [[cutObj]]
* [[cutObj]]
* [[cutRsc]]
* [[cutRsc]]
* [[cutText]]
* [[cutText]]
|
* [[titleObj]]
* [[titleObj]]
* [[titleRsc]]
* [[titleRsc]]
* [[titleText]]
* [[titleText]]
|}
|
{{Feature | Informative | The main difference between these commands is that {{hl|title*}} commands can only have a single effect on a single title layer, whereas the {{hl|cut*}} ones allow to have multiple effects on multiple cut layers. If a layer is not specified, the cut effects will be defaulted to layer 0.}}
|}


The ''Title Effect'' simply tells the game engine how to display the object, resource, or text that is passed to the command. If plain text is given, it is always white with a black shadow and in the center of the screen. The different effects are described below.
The '''Title Effect''' simply tells the game engine how to display the object, resource, or text that is passed to the command. If plain text is given, it is always white with a black shadow and horizontally centered. The different effects are described below - the effects may vary if a black or white 'curtain' is currently visible or not:


{| border="1" cellPadding="5"
{| class="wikitable" style="border: 0.33em solid #AAA"
! width="110"|Type
! style="with: 1em" |
! width="400"|Description
! Type
! Description
|-
|-
|
| "PLAIN"
| "PLAIN"
| Displays the text, object, or resource given.
| Displays the text, object, or resource given. Plain text is vertically centered.
|-
|-
| "PLAIN DOWN"
|
| Displays the text, object, or resource given. Plain text is shown centered between the third and fourth quadrant of the screen. (ie. 25% up starting at the bottom)
| style="white-space: nowrap" | "PLAIN NOFADE"
| Displays the text, object, or resource given. Plain text is vertically centered. Has no fade in and fade out.
|-
|-
|
| style="white-space: nowrap" | "PLAIN DOWN"
| Displays the text, object, or resource given. Plain text is vertically aligned to 25% from the bottom of the screen.
|-
| style="background-color: #000" |
| "BLACK"
| "BLACK"
| Causes the screen to turn completely black, and displays the optional text, object, or resource given.  All other GUI is hidden behind this black 'curtain'.
| Same as "BLACK OUT".
|-
|-
| style="background-color: #000" |
| "BLACK FADED"
| "BLACK FADED"
| Causes the screen to turn completely black without fading in, and displays the optional text, object, or resource given. All other GUI is hidden behind this black 'curtain'. If a 'speed' '''is not''' given, the 'curtain' and the displayed element disappears instantly after 5-10 seconds. Otherwise it will stay black with the element still visible.
| Causes the screen to turn completely black without fading in, and displays the optional text, object, or resource given. All other GUI is hidden behind this black 'curtain'. If a 'speed' is not given, the 'curtain' and the displayed element disappears '''instantly''' after 5-10 seconds. Otherwise it will stay black with the element still visible.
|-
|-
| style="background-color: #000" |
| "BLACK OUT"
| "BLACK OUT"
| Same as "BLACK".
| Causes the screen to turn completely black, and displays the optional text, object, or resource given. All other GUI is hidden behind this black 'curtain'.
|-
|-
| style="background-color: #000" |
| "BLACK IN"
| "BLACK IN"
| Reveals the GUI after a black 'curtain' is withdrawn along with the optional text, object, or resource that was given.
| Reveals the GUI after a black 'curtain' is withdrawn along with the optional text, object, or resource that was given.
|-
|-
| style="background-color: #FFF" |
| "WHITE OUT"
| "WHITE OUT"
| Causes the screen to turn completely white, and displays the optional text, object, or resource given. All other GUI is hidden behind this black 'curtain'. This can easily blind the player so it should be used with caution. Make sure that a fade in time is set when calling the command.
| Causes the screen to turn completely white, and displays the optional text, object, or resource given. All other GUI is hidden behind this white 'curtain'. This can easily blind the player so it should be used with caution. Make sure that a fade-in time is set when calling the command.
|-
|-
| style="background-color: #FFF" |
| "WHITE IN"
| "WHITE IN"
| Withdraws a white 'curtain' revealing the GUI.
| Withdraws a white 'curtain' revealing the GUI.
|}
|}


The effects may vary if a black or white 'curtain' is currently visible or not visible.
 
[[Category:Reference_Lists]]

Revision as of 18:54, 22 April 2022

A Title Effect Type is a String parameter that is required by a few scripting commands. The commands are used to display custom GUI elements on the front end or the back end. Six commands use this parameter:

cut* commands title* commands
ⓘ
The main difference between these commands is that title* commands can only have a single effect on a single title layer, whereas the cut* ones allow to have multiple effects on multiple cut layers. If a layer is not specified, the cut effects will be defaulted to layer 0.

The Title Effect simply tells the game engine how to display the object, resource, or text that is passed to the command. If plain text is given, it is always white with a black shadow and horizontally centered. The different effects are described below - the effects may vary if a black or white 'curtain' is currently visible or not:

Type Description
"PLAIN" Displays the text, object, or resource given. Plain text is vertically centered.
"PLAIN NOFADE" Displays the text, object, or resource given. Plain text is vertically centered. Has no fade in and fade out.
"PLAIN DOWN" Displays the text, object, or resource given. Plain text is vertically aligned to 25% from the bottom of the screen.
"BLACK" Same as "BLACK OUT".
"BLACK FADED" Causes the screen to turn completely black without fading in, and displays the optional text, object, or resource given. All other GUI is hidden behind this black 'curtain'. If a 'speed' is not given, the 'curtain' and the displayed element disappears instantly after 5-10 seconds. Otherwise it will stay black with the element still visible.
"BLACK OUT" Causes the screen to turn completely black, and displays the optional text, object, or resource given. All other GUI is hidden behind this black 'curtain'.
"BLACK IN" Reveals the GUI after a black 'curtain' is withdrawn along with the optional text, object, or resource that was given.
"WHITE OUT" Causes the screen to turn completely white, and displays the optional text, object, or resource given. All other GUI is hidden behind this white 'curtain'. This can easily blind the player so it should be used with caution. Make sure that a fade-in time is set when calling the command.
"WHITE IN" Withdraws a white 'curtain' revealing the GUI.
Retrieved from "https://community.bistudio.com/wiki?title=Title_Effect_Type&oldid=308987"