cutText

From Bohemia Interactive Community
Jump to: navigation, search
Introduced with Operation Flashpoint version 1.00
  Effects of this scripting command are not broadcasted over the network and remain local to the client the command is executed on

Click on the images for descriptions

Introduced in

Game:
Operation Flashpoint
Version:
1.00

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 logo black.png For greater efficiency and ease of modability it is recommended to use named layers available with alternative syntax since Arma 3 v1.57.134673

Syntax

Syntax:
cutText [text, type, speed, showInMap, isStructuredText]
Parameters:
[text, type, speed, showInMap, isStructuredText]: Array
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 (Optional): Number - Time in seconds to fade in resource. Default: -1
showInMap (Optional): Boolean - false to hide the text when the map is opened. Default: true    (Introduced in ARMA 3 )
isStructuredText (Optional): Boolean - true to switch support for Structured Text formatting. Default: false (See Example 4. Available since Arma 3 v1.73.142260)
Return Value:
Nothing

Alternative Syntax

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, type, speed, showInMap, isStructuredText]: Array
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 (Optional): Number - Time in seconds to fade in resource. Default: -1
showInMap (Optional): Boolean - false to hide the text when the map is opened. Default: true    (Introduced in ARMA 3 )
isStructuredText (Optional): Boolean - true to switch support for Structured Text formatting. Default: false (See Example 4. Available since Arma 3 v1.73.142260)
Return Value:
Nothing

Alternative Syntax 2

Syntax:
layerName cutText [text, type, speed, showInMap, isStructuredText]        (Since Arma 3 v1.57.134673)
Parameters:
layerName: String - layer name on which the effect is shown. Layer names are CaSe SeNsItIvE
[text, type, speed, showInMap, isStructuredText]: Array
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 (Optional): Number - Time in seconds to fade in resource. Default: -1
showInMap (Optional): Boolean - false to hide the text when the map is opened. Default: true    (Introduced in ARMA 3 )
isStructuredText (Optional): Boolean - true to switch support for Structured Text formatting. Default: false (See Example 4. Available since Arma 3 v1.73.142260)
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

Multiplayer:
-
See also:
allCutLayerstitleTextcutRsccutObjcutFadeOut

Notes

Only post proven facts here. Report bugs on the feedback tracker. Use the talk page or the forums for discussions.
Add New Note | How To

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)