cutText: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "_{10,} " to "")
m (Text replacement - " *\| *([Cc]omments|COMMENTS|Game|[Gg]ame [Nn]ame|Game [Vv]ersion|Game Version \(number surrounded by NO SPACES\)|Multiplayer Arguments( \("local" or "global"\))?|Effects|Multiplayer Effects( \("local" or "global"\))?|Multiplayer Exe...)
Line 1: Line 1:
{{Command|Comments=
{{Command


| ofp |Game name=
| ofp


|1.00|Game version=
|1.00


|eff= local |Multiplayer Effects=
|eff= local


|gr1= GUI Control |GROUP1=
|gr1= GUI Control


| Displays a text message in the center of the screen. The text can be displayed on multiple lines by using "\n" new line characters:<br><tt>[[cutText]] ["line1\nline2\nline3", "PLAIN"];</tt>. Since Arma 3 v1.73.142260 this command supports [[Structured Text]] formatting.
| Displays a text message in the center of the screen. The text can be displayed on multiple lines by using "\n" new line characters:<br><tt>[[cutText]] ["line1\nline2\nline3", "PLAIN"];</tt>. Since Arma 3 v1.73.142260 this command supports [[Structured Text]] formatting.


{{Feature|arma3|For greater efficiency and ease of modability it is recommended to use named layers available with alternative syntax since Arma 3 v1.57.134673}} |DESCRIPTION=
{{Feature|arma3|For greater efficiency and ease of modability it is recommended to use named layers available with alternative syntax since Arma 3 v1.57.134673}}


| '''cutText''' [text, type, speed,  showInMap, isStructuredText] |SYNTAX=
| '''cutText''' [text, type, speed,  showInMap, isStructuredText]


|p1= text: [[String]] - text to be displayed |PARAMETER1=
|p1= text: [[String]] - text to be displayed


|p2= 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. |PARAMETER2=
|p2= 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.


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


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


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


| [[Nothing]] |RETURNVALUE=
| [[Nothing]]


|s2= layer '''cutText''' [text, type, speed,  showInMap, isStructuredText] |SYNTAX2=
|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. |PARAMETER21=
Line 41: Line 41:
|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}} |PARAMETER26=


|r2= [[Nothing]] |RETURNVALUE2=
|r2= [[Nothing]]


|s3= layerName '''cutText''' [text, type, speed,  showInMap, isStructuredText] {{Since|arma3|1.57.134673|y}} |SYNTAX3=
|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 |PARAMETER41=
Line 57: Line 57:
|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}} |PARAMETER47=


|r3= [[Number]] - number of the allocated layer |RETURNVALUE3=
|r3= [[Number]] - number of the allocated layer
   
   
|x1= <code>[[cutText]] ["", "BLACK OUT"];
|x1= <code>[[cutText]] ["", "BLACK OUT"];
[[cutText]] ["Hello World!", "PLAIN", 2];</code> |EXAMPLE1=
[[cutText]] ["Hello World!", "PLAIN", 2];</code>


|x2= <code>2 [[cutText]] ["Hello World!", "PLAIN", 2];</code> |EXAMPLE2=
|x2= <code>2 [[cutText]] ["Hello World!", "PLAIN", 2];</code>


|x3= <code>_layer1 = "normal" [[cutText]] ["In The Centre", "PLAIN"];
|x3= <code>_layer1 = "normal" [[cutText]] ["In The Centre", "PLAIN"];
_layer2 = "down" [[cutText]] ["At The Bottom", "PLAIN DOWN"];</code> |EXAMPLE3=
_layer2 = "down" [[cutText]] ["At The Bottom", "PLAIN DOWN"];</code>


|x4=Since Arma 3 v1.73.142260:<code>[[cutText]] ["&lt;t color='#ff0000' size='5'>RED ALERT!&lt;/t>&lt;br/>***********", "PLAIN", -1, [[true]], [[true]]];</code> |EXAMPLE4=
|x4=Since Arma 3 v1.73.142260:<code>[[cutText]] ["&lt;t color='#ff0000' size='5'>RED ALERT!&lt;/t>&lt;br/>***********", "PLAIN", -1, [[true]], [[true]]];</code>


| [[allCutLayers]], [[titleText]], [[cutRsc]], [[cutObj]], [[cutFadeOut]], [[allActiveTitleEffects]] |SEEALSO=
| [[allCutLayers]], [[titleText]], [[cutRsc]], [[cutObj]], [[cutFadeOut]], [[allActiveTitleEffects]]
}}
}}


Revision as of 00:27, 18 January 2021

Logo A0.png1.00
LELocal
Hover & click on the images for description

Description

Description:
Displays a text message in the center of the screen. The text can be displayed on multiple lines by using "\n" new line characters:
cutText ["line1\nline2\nline3", "PLAIN"];. Since Arma 3 v1.73.142260 this command supports Structured Text formatting.
Arma 3
For greater efficiency and ease of modability it is recommended to use named layers available with alternative syntax since Arma 3 v1.57.134673
Groups:
GUI Control

Syntax 1

Syntax:
cutText [text, type, speed, showInMap, isStructuredText]
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:
Nothing

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:
allCutLayerstitleTextcutRsccutObjcutFadeOutallActiveTitleEffects

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

Notes

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.

Bottom Section

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)
Retrieved from "https://community.bistudio.com/wiki?title=cutText&oldid=204403"