Title Effect Type: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(making the article, saving progress)
 
No edit summary
(13 intermediate revisions by 7 users not shown)
Line 1: Line 1:
Many commands relating to GUI Interaction require a string often called ''type''.  This type tells the game engine how to show text, objects, or resources. The possible ''types'' and their descriptions are shown below:
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:
{| border="1" cellPadding="5"
 
! width="110"|Type
{|
! width="400"|Description
|
{| style="min-width: 20em"
! cut* commands !! title* commands
|-
|-
|
* [[cutObj]]
* [[cutRsc]]
* [[cutText]]
|
* [[titleObj]]
* [[titleRsc]]
* [[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 horizontally centered. The different effects are described below - the effects may vary if a black or white 'curtain' is currently visible or not:
{| class="wikitable" style="border: 0.33em solid #AAA"
! style="with: 1em" |
! Type
! Description
|-
|
| "PLAIN"
| "PLAIN"
| (description for plain)
| Displays the text, object, or resource given. Plain text is vertically centered.
|-
|
| 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.
|-
|-
| "PLAIN DOWN"
|
| (description for plain down)
| 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"
| (description for black)
| Same as "BLACK OUT".
|-
|-
| style="background-color: #000" |
| "BLACK FADED"
| "BLACK FADED"
| (description for 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.
|-
|-
| style="background-color: #000" |
| "BLACK OUT"
| "BLACK OUT"
| Causes the screen to turn completely black, and displays the optional text, object, or resource given. Text is shown in white.  All other GUI is hidden behind this black 'curtain'.
| 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"
| Withdraws a black 'curtain' revealing the GUI.
| 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 GUI is hidden behind this black 'curtain'. This can easily blind the player and is not recommended.
| 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.
|}
|}
[[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"