cutObj: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (template:command argument fix)
m (Text replacement - "(\|p[0-9]+ *= *[^(]+\(Optional(, default[^)]*)\) )T([a-z])" to "$1t$3")
 
(67 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| ofp |= Game name
|game1= ofp
|version1= 1.00


|1.00|= Game version
|game2= ofpe
|version2= 1.00


|eff= local |Multiplayer Effects=
|game3= arma1
____________________________________________________________________________________________
|version3= 1.00


| Displays an object defined in the global config in CfgTitles.<br><br>
|game4= arma2
{{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=
|version4= 1.00
____________________________________________________________________________________________


| '''cutObj''' [class, type, speed, showInMap] |SYNTAX=
|game5= arma2oa
|p1= [class, type, speed, showInMap]: [[Array]] |=
|version5= 1.50
|p2= class: [[String]] - the className of the object |PARAMETER3=
|p3= 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=
|p4= speed (Optional): [[Number]] - Time in seconds to fade in resource. Default: -1 |PARAMETER3=
|p5= showInMap (Optional): [[Boolean]] - [[false]] to hide the text when the map is opened. Default: [[true]]  |PARAMETER3=
| [[Nothing]] |RETURNVALUE=


|s2= layer '''cutObj''' [class, type, speed, showInMap] |SYNTAX=
|game6= tkoh
|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. |PARAMETER1=
|version6= 1.00
|p22= [class, type, speed, showInMap]: [[Array]] |=
|p23= class: [[String]] - the className of the object |PARAMETER3=
|p24= 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=
|p25= speed (Optional): [[Number]] - Time in seconds to fade in resource. Default: -1 |PARAMETER3=
|p26= showInMap (Optional): [[Boolean]] - [[false]] to hide the text when the map is opened. Default: [[true]]  |PARAMETER3=  |=


|r2= [[Nothing]] |RETURNVALUE=
|game7= arma3
|version7= 0.50


|s3= layerName '''cutObj''' [class, type, speed, showInMap] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(''Since Arma 3 v1.57.134673'') |SYNTAX=
|gr1= GUI Control
|p41= layerName: [[String]] - layer name on which the effect is shown. Layer names are CaSe SeNsItIvE|PARAMETER1=
|p42= [class, type, speed, showInMap]: [[Array]] |=
|p43= class: [[String]] - the className of the object |PARAMETER3=
|p44= 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=
|p45= speed (Optional): [[Number]] - Time in seconds to fade in resource. Default: -1 |PARAMETER3=
|p46= showInMap (Optional): [[Boolean]] - [[false]] to hide the text when the map is opened. Default: [[true]]  |PARAMETER3= |=


|r3= [[Number]] - number of the allocated layer |RETURNVALUE=
|eff= local
____________________________________________________________________________________________
 
|x1= <code>[[cutObj]] ["TVSet", "PLAIN"];
[[cutObj]] ["TVSet", "PLAIN", 2]</code> |EXAMPLE1=


|x2= <code>2 [[cutObj]] ["Sphere", "PLAIN"];</code> |EXAMPLE2=
|descr= Displays an object defined in the global config in {{hl|CfgTitles}}.
{{Feature|arma3|For greater efficiency and ease of modability, it is recommended to use named layers with {{Link|#Syntax 3}}.}}


|x3= <code>_layer = "layer1" [[cutObj]] ["BISLogo", "PLAIN"];</code> |EXAMPLE3=
|s1= [[cutObj]] [class, type, speed, showInMap, drawOverHUD]
____________________________________________________________________________________________


| [[allCutLayers]], [[titleObj]], [[cutText]], [[cutRsc]], [[cutFadeOut]] |SEEALSO=
|p1= class: [[String]] - the className of the object defined in {{hl|[[configFile]] >> "CfgTitles" >> class}}


}}
|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
 
|p4= showInMap: [[Boolean]] - (Optional, default [[true]]) [[false]] to hide the text when the map is opened
 
|p5= drawOverHUD: [[Boolean]] - (Optional, default [[true]]) [[false]] to show the object under in-game HUD
|p5since= arma3 2.16
 
|r1= [[Nothing]]
 
|s2= layer [[cutObj]] [class, type, speed, showInMap, drawOverHUD]
 
|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= class: [[String]] - the className of the object defined in {{hl|[[configFile]] >> "CfgTitles" >> class}}
 
|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
 
|p25= showInMap: [[Boolean]] - (Optional, default [[true]]) [[false]] to hide the text when the map is opened
 
|p26= drawOverHUD: [[Boolean]] - (Optional, default [[true]]) [[false]] to show the object under in-game HUD
|p26since= arma3 2.16
 
|r2= [[Nothing]]
 
|s3= layerName [[cutObj]] [class, type, speed, showInMap, drawOverHUD]
 
|s3since= arma3 1.58
 
|p41= layerName: [[String]] - layer name on which the effect is shown. Layer names are CaSe SeNsItIvE
 
|p42= class: [[String]] - the className of the object defined in {{hl|[[configFile]] >> "CfgTitles" >> class}}
 
|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
 
|p45= showInMap: [[Boolean]] - (Optional, default [[true]]) [[false]] to hide the text when the map is opened
 
|p46= drawOverHUD: [[Boolean]] - (Optional, default [[true]]) [[false]] to show the object under in-game HUD
|p46since= arma3 2.16
 
|r3= [[Number]] - number of the allocated layer


<h3 style="display:none">Notes</h3>
|x1= <sqf>
<dl class="command_description">
cutObj ["TVSet", "PLAIN"];
<!-- Note Section BEGIN -->
cutObj ["TVSet", "PLAIN", 2];
</sqf>


<!-- Note Section END -->
|x2= <sqf>2 cutObj ["Sphere", "PLAIN"];</sqf>
</dl>


<h3 style="display:none">Bottom Section</h3>
|x3= <sqf>private _layer = "layer1" cutObj ["BISLogo", "PLAIN"];</sqf>


[[Category:Scripting Commands|CUTOBJ]]
|seealso= [[allCutLayers]] [[titleObj]] [[cutText]] [[cutRsc]] [[cutFadeOut]] [[allActiveTitleEffects]] [[activeTitleEffectParams]]  
[[Category:Scripting Commands OFP 1.99|CUTOBJ]]
}}
[[Category:Scripting Commands OFP 1.96|CUTOBJ]]
[[Category:Scripting Commands OFP 1.46|CUTOBJ]]
[[Category:Scripting Commands ArmA|CUTOBJ]]
[[Category:Command_Group:_Interaction|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]

Latest revision as of 12:32, 8 November 2023

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 an object defined in the global config in CfgTitles.
Arma 3
For greater efficiency and ease of modability, it is recommended to use named layers with Syntax 3.
Groups:
GUI Control

Syntax 1

Syntax:
cutObj [class, type, speed, showInMap, drawOverHUD]
Parameters:
class: String - the className of the object defined in configFile >> "CfgTitles" >> class
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
since Arma 3 logo black.png2.16
drawOverHUD: Boolean - (Optional, default true) false to show the object under in-game HUD
Return Value:
Nothing

Syntax 2

Syntax:
layer cutObj [class, type, speed, showInMap, drawOverHUD]
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
class: String - the className of the object defined in configFile >> "CfgTitles" >> class
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
since Arma 3 logo black.png2.16
drawOverHUD: Boolean - (Optional, default true) false to show the object under in-game HUD
Return Value:
Nothing

Syntax 3

Syntax:
layerName cutObj [class, type, speed, showInMap, drawOverHUD]
Parameters:
layerName: String - layer name on which the effect is shown. Layer names are CaSe SeNsItIvE
class: String - the className of the object defined in configFile >> "CfgTitles" >> class
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
since Arma 3 logo black.png2.16
drawOverHUD: Boolean - (Optional, default true) false to show the object under in-game HUD
Return Value:
Number - number of the allocated layer

Examples

Example 1:
cutObj ["TVSet", "PLAIN"]; cutObj ["TVSet", "PLAIN", 2];
Example 2:
2 cutObj ["Sphere", "PLAIN"];
Example 3:
private _layer = "layer1" cutObj ["BISLogo", "PLAIN"];

Additional Information

See also:
allCutLayers titleObj cutText cutRsc 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
Retrieved from "https://community.bistudio.com/wiki?title=cutObj&oldid=348145"