cutText: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\|x([0-9])= *<code>([^<]*)<\/code>" to "|x$1= <sqf>$2</sqf>")
m (Some wiki formatting)
Line 26: Line 26:
|gr1= GUI Control
|gr1= GUI Control


|descr= 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>{{hl|[[cutText]] ["line1\nline2\nline3", "PLAIN"];}}. Since Arma 3 v1.74 this command supports [[Structured Text]] formatting.
|descr= Displays a text message in the center of the screen. The text can be displayed on multiple lines by using "\n" new line characters:
<sqf>cutText ["line1\nline2\nline3", "PLAIN"];</sqf>


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


|s1= [[cutText]] [text, type, speed, showInMap, isStructuredText]
|s1= [[cutText]] [text, type, speed, showInMap, isStructuredText]


|p1= text: [[String]] - text to be displayed
|p1= text: [[String]] - text to be displayed
Line 46: Line 47:
|r1= [[Nothing]]
|r1= [[Nothing]]


|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.
|s2since= arma3 1.58
 
|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
|p22= text: [[String]] - text to be displayed
Line 64: Line 67:
|r2= [[Nothing]]
|r2= [[Nothing]]


|s3= layerName [[cutText]] [text, type, speed, showInMap, isStructuredText]
|s3= layerName [[cutText]] [text, type, speed, showInMap, isStructuredText]


|s3since= arma3 1.58
|s3since= arma3 1.58
Line 74: Line 77:
|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.
|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.
|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
|p45= showInMap: [[Boolean]] - (Optional, default [[true]]) [[false]] to hide the text when the map is opened
|p45since= arma3 0.50


|p47= isStructuredText: [[Boolean]] - (Optional, default [[false]]) [[true]] to switch support for [[Structured Text]] formatting - see {{HashLink|#Example 4}}
|p46= isStructuredText: [[Boolean]] - (Optional, default [[false]]) [[true]] to switch support for [[Structured Text]] formatting - see {{HashLink|#Example 4}}
|p47since= arma3 1.74
|p46since= arma3 1.74


|r3= [[Number]] - number of the allocated layer
|r3= [[Number]] - number of the allocated layer
Line 91: Line 95:
_layer2 = "down" cutText ["At The Bottom", "PLAIN DOWN"];</sqf>
_layer2 = "down" cutText ["At The Bottom", "PLAIN DOWN"];</sqf>


|x4= <sqf>cutText ["&lt;t color='#ff0000' size='5'>RED ALERT!&lt;/t>&lt;br/>***********", "PLAIN", -1, true, true];</sqf>
|x4= <sqf>cutText ["<t color='#ff0000' size='5'>RED ALERT!</t><br/>***********", "PLAIN", -1, true, true];</sqf>


|seealso= [[allCutLayers]] [[titleText]] [[cutRsc]] [[cutObj]] [[cutFadeOut]] [[allActiveTitleEffects]] [[activeTitleEffectParams]]  
|seealso= [[allCutLayers]] [[titleText]] [[cutRsc]] [[cutObj]] [[cutFadeOut]] [[allActiveTitleEffects]] [[activeTitleEffectParams]]  
}}
}}


<dl class="command_description">
{{Note
 
|user= Krzmbrzl00
<dt></dt>
|timestamp= 20160706133200
<dd class="notedate">Posted on September 20, 2013 - 06:59</dd>
|text= The value for '''speed''' has to be greater 0. If 0 is used as speed the default value (1) will be used.<br>
<dt class="note">[[User:Killzone_Kid|Killzone_Kid]]</dt>
<dd class="note">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.</dd>
 
 
<dt></dt>
<dd class="notedate">Posted on July 6, 2016 - 13:32 (UTC)</dd>
<dt class="note">[[User:Krzmbrzl00|Krzmbrzl00]]</dt>
<dd class="note">
The value for '''speed''' has to be greater 0. If 0 is used as speed the default value (1) will be used.<br>
If you want to create an "instant" effect you can use a really small value (e.g. 0.001)
If you want to create an "instant" effect you can use a really small value (e.g. 0.001)
</dd>
}}
 
</dl>

Revision as of 19:21, 28 August 2022

Logo A0.png1.00ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
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"];
Arma 3
For greater efficiency and ease of modability it is recommended to use named layers through the alternative syntax.
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.
since Arma 3 logo black.png0.50
showInMap: Boolean - (Optional, default true) false to hide the text when the map is opened
since Arma 3 logo black.png1.74
isStructuredText: Boolean - (Optional, default false) true to switch support for Structured Text formatting - see Example 4
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.
since Arma 3 logo black.png0.50
showInMap: Boolean - (Optional, default true) false to hide the text when the map is opened
since Arma 3 logo black.png1.74
isStructuredText: Boolean - (Optional, default false) true to switch support for Structured Text formatting - see Example 4
Return Value:
Nothing

Syntax 3

Syntax:
layerName cutText [text, type, speed, showInMap, isStructuredText]
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.
since Arma 3 logo black.png0.50
showInMap: Boolean - (Optional, default true) false to hide the text when the map is opened
since Arma 3 logo black.png1.74
isStructuredText: Boolean - (Optional, default false) true to switch support for Structured Text formatting - see Example 4
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:
cutText ["<t color='#ff0000' size='5'>RED ALERT!</t><br/>***********", "PLAIN", -1, true, true];

Additional Information

See also:
allCutLayers titleText cutRsc cutObj cutFadeOut allActiveTitleEffects activeTitleEffectParams

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
Krzmbrzl00 - c
Posted on Jul 06, 2016 - 13:32 (UTC)
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=330243"