cutText: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "{{Command " to "{{RV|type=command ")
m (Text replacement - " *\| *PARAMETER[0-9]{1,3} *= * " to " ")
Line 29: Line 29:
|s2= layer '''cutText''' [text, type, speed,  showInMap, isStructuredText]
|s2= layer '''cutText''' [text, type, speed,  showInMap, isStructuredText]


|p21= layer: [[Number]] -  layer number on which the effect is shown, where 0 is the back most. Layer number is rounded to the nearest integer and also cannot be negative. Layer 99.5 will be treated as layer 100. |PARAMETER21=
|p21= layer: [[Number]] -  layer number on which the effect is shown, where 0 is the back most. Layer number is rounded to the nearest integer and also cannot be negative. Layer 99.5 will be treated as layer 100.


|p22= text: [[String]] - text to be displayed |PARAMETER22=
|p22= text: [[String]] - text to be displayed


|p23= type: [[String]] one of "PLAIN", "PLAIN DOWN", "BLACK", "BLACK FADED", "BLACK OUT", "BLACK IN", "WHITE OUT" and "WHITE IN". See [[Title Effect Type]]s for more information about these values. |PARAMETER23=
|p23= type: [[String]] one of "PLAIN", "PLAIN DOWN", "BLACK", "BLACK FADED", "BLACK OUT", "BLACK IN", "WHITE OUT" and "WHITE IN". See [[Title Effect Type]]s for more information about these values.


|p24= speed: [[Number]] - (Optional, default -1) time in seconds to fade in resource. |PARAMETER24=
|p24= speed: [[Number]] - (Optional, default -1) time in seconds to fade in resource.


|p25= showInMap: [[Boolean]] - (Optional, default [[true]]) [[false]] to hide the text when the map is opened. |PARAMETER25=
|p25= showInMap: [[Boolean]] - (Optional, default [[true]]) [[false]] to hide the text when the map is opened.


|p26= isStructuredText: [[Boolean]] - (Optional, default [[false]]) [[true]] to switch support for [[Structured Text]] formatting - see Example 4. {{Since|arma3|1.73.142260|y}} |PARAMETER26=
|p26= isStructuredText: [[Boolean]] - (Optional, default [[false]]) [[true]] to switch support for [[Structured Text]] formatting - see Example 4. {{Since|arma3|1.73.142260|y}}


|r2= [[Nothing]]
|r2= [[Nothing]]
Line 45: Line 45:
|s3= layerName '''cutText''' [text, type, speed,  showInMap, isStructuredText] {{Since|arma3|1.57.134673|y}}
|s3= layerName '''cutText''' [text, type, speed,  showInMap, isStructuredText] {{Since|arma3|1.57.134673|y}}


|p41= layerName: [[String]] - layer name on which the effect is shown. Layer names are CaSe SeNsItIvE |PARAMETER41=
|p41= layerName: [[String]] - layer name on which the effect is shown. Layer names are CaSe SeNsItIvE


|p42= text: [[String]] - text to be displayed |PARAMETER42=
|p42= text: [[String]] - text to be displayed


|p43= type: [[String]] one of "PLAIN", "PLAIN DOWN", "BLACK", "BLACK FADED", "BLACK OUT", "BLACK IN", "WHITE OUT" and "WHITE IN". See [[Title Effect Type]]s for more information about these values. |PARAMETER43=
|p43= type: [[String]] one of "PLAIN", "PLAIN DOWN", "BLACK", "BLACK FADED", "BLACK OUT", "BLACK IN", "WHITE OUT" and "WHITE IN". See [[Title Effect Type]]s for more information about these values.


|p44= speed: [[Number]] - (Optional, default -1) Time in seconds to fade in resource. |PARAMETER44=
|p44= speed: [[Number]] - (Optional, default -1) Time in seconds to fade in resource.


|p46= showInMap: [[Boolean]] - (Optional, default [[true]]) [[false]] to hide the text when the map is opened. {{Since|arma3||y}} |PARAMETER46=
|p46= showInMap: [[Boolean]] - (Optional, default [[true]]) [[false]] to hide the text when the map is opened. {{Since|arma3||y}}


|p47= isStructuredText: [[Boolean]] - (Optional, default [[false]]) [[true]] to switch support for [[Structured Text]] formatting - see Example 4. {{Since|arma3|1.73.142260|y}} |PARAMETER47=
|p47= isStructuredText: [[Boolean]] - (Optional, default [[false]]) [[true]] to switch support for [[Structured Text]] formatting - see Example 4. {{Since|arma3|1.73.142260|y}}


|r3= [[Number]] - number of the allocated layer
|r3= [[Number]] - number of the allocated layer

Revision as of 19:16, 29 January 2021

Hover & click on the images for description

Description

Description:
Description needed
Groups:
GUI Control

Syntax 1

Syntax:
Syntax needed
Parameters:
text: String - text to be displayed
type: String one of "PLAIN", "PLAIN DOWN", "BLACK", "BLACK FADED", "BLACK OUT", "BLACK IN", "WHITE OUT" and "WHITE IN". See Title Effect Types for more information about these values.
speed: Number - (Optional, default -1) time in seconds to fade in resource.
showInMap: Boolean - (Optional, default true) false to hide the text when the map is opened. Template:Since
isStructuredText: Boolean - (Optional, default false) true to switch support for Structured Text formatting - see Example 4. Template:Since
Return Value:
Return value needed

Syntax 2

Syntax:
layer cutText [text, type, speed, showInMap, isStructuredText]
Parameters:
layer: Number - layer number on which the effect is shown, where 0 is the back most. Layer number is rounded to the nearest integer and also cannot be negative. Layer 99.5 will be treated as layer 100.
text: String - text to be displayed
type: String one of "PLAIN", "PLAIN DOWN", "BLACK", "BLACK FADED", "BLACK OUT", "BLACK IN", "WHITE OUT" and "WHITE IN". See Title Effect Types for more information about these values.
speed: Number - (Optional, default -1) time in seconds to fade in resource.
showInMap: Boolean - (Optional, default true) false to hide the text when the map is opened.
isStructuredText: Boolean - (Optional, default false) true to switch support for Structured Text formatting - see Example 4. Template:Since
Return Value:
Nothing

Syntax 3

Syntax:
layerName cutText [text, type, speed, showInMap, isStructuredText] Template:Since
Parameters:
layerName: String - layer name on which the effect is shown. Layer names are CaSe SeNsItIvE
text: String - text to be displayed
type: String one of "PLAIN", "PLAIN DOWN", "BLACK", "BLACK FADED", "BLACK OUT", "BLACK IN", "WHITE OUT" and "WHITE IN". See Title Effect Types for more information about these values.
speed: Number - (Optional, default -1) Time in seconds to fade in resource.
showInMap: Boolean - (Optional, default true) false to hide the text when the map is opened. Template:Since
isStructuredText: Boolean - (Optional, default false) true to switch support for Structured Text formatting - see Example 4. Template:Since
Return Value:
Number - number of the allocated layer

Examples

Example 1:
cutText ["", "BLACK OUT"]; cutText ["Hello World!", "PLAIN", 2];
Example 2:
2 cutText ["Hello World!", "PLAIN", 2];
Example 3:
_layer1 = "normal" cutText ["In The Centre", "PLAIN"]; _layer2 = "down" cutText ["At The Bottom", "PLAIN DOWN"];
Example 4:
Since Arma 3 v1.73.142260:cutText ["<t color='#ff0000' size='5'>RED ALERT!</t><br/>***********", "PLAIN", -1, true, true];

Additional Information

See also:
See also needed

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
Posted on September 20, 2013 - 06:59
Killzone_Kid
In Arma 3 "PLAIN" param will display your text where the crosshair is, "PLAIN DOWN" will push the text further down, closer to the bottom of the screen.
Posted on July 6, 2016 - 13:32 (UTC)
Krzmbrzl00
The value for speed has to be greater 0. If 0 is used as speed the default value (1) will be used.
If you want to create an "instant" effect you can use a really small value (e.g. 0.001)