hintC: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(can be dragged)
m (Text replacement - "[] spawn" to "0 spawn")
 
(49 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 |= Effects in MP
|game3= arma1
____________________________________________________________________________________________
|version3= 1.00


| Displays attractive hint in the center of the screen. Player control is taken away until user presses "Continue". After user confirmation, the content of the [[hintC]] is repeated again in a normal [[hint]]. This type of hint can also have a title. It is also possible to drag this type of hint around the screen.|= Description
|game4= arma2
___________________________________________________________________________________________
|version4= 1.00


| '''hintC''' content |= Syntax
|game5= arma2oa
|p1 =  content: [[String]]
|version5= 1.50
| [[Nothing]]  |= Return value


____________________________________________________________________________________________
|game6= tkoh
|version6= 1.00


|s2= title '''hintC''' [content1, content2, ...] |= Syntax2
|game7= arma3
|version7= 0.50


|p21= title: [[String]] |= Parameter 1
|eff= local


|p22= [content1, content2, ...]: [[Array]] of [[String]]s or [[Structured Text]]s. |= Parameter 2
|gr1= Interaction


|gr2= Structured Text


|r2= [[Nothing]] |= Return value
|gr3= Strings


____________________________________________________________________________________________
|descr= Displays a very basic message dialog in the center of the screen. Player control is taken away until "Continue" is pressed. The message dialog can be dragged around on the screen. After "Continue" has been pressed, the content of the [[hintC]] is repeated in a normal [[hint]].
{{Feature|informative|In Singleplayer, the game is paused while the message dialog is visible.}}


|s3= title '''hintC''' content |= Syntax3
|s1= [[hintC]] message


|p41= title: [[String]] |= Parameter 1
|p1= message: [[String]]


|p42= content: [[Structured Text]] |= Parameter 2
|r1= [[Nothing]]


|r3= [[Nothing]] |= Return value
|s2= title [[hintC]] message
____________________________________________________________________________________________


|s4= title '''hintC''' content |= Syntax3
|p21= title: [[String]] - message title


|p61= title: [[String]] |= Parameter 1
|p22= message: [[String]], [[Structured Text]], [[Array]] of [[String]]s or [[Array]] of [[Structured Text]]


|p62= content: [[String]] |= Parameter 2
|r2= [[Nothing]]


|r4= [[Nothing]] |= Return value
|x1= <sqf>hintC "Press W to move forward";</sqf>
____________________________________________________________________________________________
|x1 = <code>[[hintC]] "Press W to move forward"; </code>


|x2 = Same as the above in Arma3 but without second [[hint]] displayed:<code>[[hintC]] "Press W to move forward";
|x2= Same as the above in {{arma3}} but without second [[hint]] displayed:<br>[[File:HintC.jpg|400px|right]]
hintC_EH = [[findDisplay]] 57 [[displayAddEventHandler]] ["unload", {
<sqf>
0 = _this [[spawn]] {
hintC "Press W to move forward";
_this [[select]] 0 [[displayRemoveEventHandler]] ["unload", hintC_EH];
hintC_EH = findDisplay 57 displayAddEventHandler ["Unload", {
[[hintSilent]] "";
_this spawn {
_this select 0 displayRemoveEventHandler ["Unload", hintC_EH];
hintSilent "";
};
};
}];</code>
}];
</sqf>


[[Image:HintC.jpg|400px]]
|x3= <sqf>
 
"Instructions" hintC [
|x3= <code>"Instructions" '''hintC''' [
"Press W to move forward.",
"Press W to move forward.",
"Press S to move backwards.",
"Press S to move backwards.",
"Use the mouse to turn right or left.",
"Use the mouse to turn right or left.",
"Press V for weapon sights."
"Press V for weapon sights."
];</code> |= Example 1
];
|x4= Same as the above in Arma3 but without second [[hint]] displayed: <code>"Instructions" '''hintC''' [
</sqf>
 
|x4= Same as the above in {{arma3}} but without second [[hint]] displayed:<br>[[File:HintC_array.jpg|400px|right]]
<sqf>
"Instructions" hintC [
"Press W to move forward.",
"Press W to move forward.",
"Press S to move backwards.",
"Press S to move backwards.",
Line 70: Line 77:
"Press V for weapon sights."
"Press V for weapon sights."
];
];
hintC_arr_EH = [[findDisplay]] 72 [[displayAddEventHandler]] ["unload", {
hintC_EH = findDisplay 72 displayAddEventHandler ["Unload", {
0 = _this [[spawn]] {
_this spawn {
_this [[select]] 0 [[displayRemoveEventHandler]] ["unload", hintC_arr_EH];
_this select 0 displayRemoveEventHandler ["Unload", hintC_EH];
[[hintSilent]] "";
hintSilent "";
};
};
}];</code>  
}];
</sqf>


[[Image:HintC_array.jpg|400px]] |= Example 2
|x5= <sqf>
private _separator = parseText "<br/>------------------------<br/>";
private _image = "\ca\ui\textures\aus_flag.paa";
private _message = composeText [image _image, "Heading Text", _separator, "Content"];
"" hintC _message;
</sqf>


|x5= <code>_separator1 = [[parseText]] "<nowiki><br />------------------------<br /></nowiki>";
|seealso= [[hint]] [[hintCadet]] [[hintSilent]] [[BIS_fnc_guiMessage]]
_image = "\ca\ui\textures\aus_flag.paa";
}}
_txt = [[composeText]] <nowiki>[</nowiki>[[image]] _image, "Heading Text", _separator1, "Content"];
[[hintC]] _txt;</code> |=Example 5


| [[hint]], [[hintCadet]], [[hintSilent]] |= See also
{{Note
|user= Str
|timestamp= 20060731181800
|text= This command must be executed after mission start. If you place it into init.sqs or init field of some unit, it will not work. Just add a little delay (~0.001) and the place the command.
}}


{{Note
|user= Worldeater
|timestamp= 20090515234200
|text= To display multiple messages after another you have to add a small delay in between. Otherwise only the first message will be displayed.
<sqf>hintC "foo"; sleep 0.1; hintC "bar"</sqf>
Without a [[sleep]] statement [[hintC]] will not suspend the script it has been called from.
}}
}}
<h3 style="display:none">Notes</h3>
<dl class="command_description">
<!-- Note Section BEGIN -->
<dt class="note">'''[[User:Str|Str]]'''
<dd class="note">This command must be executed after mission start. If you place it into init.sqs or init field of some unit, it will not work. Just add a little delay (~0.001) and the place the command.
<dt class="note">'''[[User:Worldeater|Worldeater]]'''
<dd class="note">To display multiple messages after another you have to add a small delay in between. Otherwise only the first message will be displayed. hintC "foo"; sleep 0.1; hintC "bar"; Without a [[sleep]] statement ''hintC'' will not suspend the script it has been called from.
<!-- Note Section END -->
<dt class="note">'''[[User:ArmAtec|ArmAtec]]'''
<dd class="note">HintC can be used with formatting like this: HintC format["Hello %1",player].
</dl>


<h3 style="display:none">Bottom Section</h3>
{{Note
[[Category:Scripting Commands|HINTC]]
|user= Killzone_Kid
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
|timestamp= 20150319095200
[[Category:Scripting Commands OFP 1.96|HINTC]]
|text= "Titled" [[hintC]] uses {{hl|display #72}} while "untitled" one uses {{hl|display #57}}. If you are trying examples in Arma 3 debug console, add a little delay like this:
[[Category:Scripting Commands OFP 1.46|HINTC]]
<sqf>0 spawn { sleep 0.5; /* your example code goes here*/ };</sqf> or no [[hintC]] will be displayed.
[[Category:Scripting Commands ArmA|HINTC]]
}}
[[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}}}}]]
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on March 19, 2015 - 09:52 (UTC)</dd>
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
<dd class="note">
"Titled" [[hintC]] all use display #72 while "untitled" one uses display #57. If you are trying examples in Arma 3 debug console, add little delay like this: <code>[] spawn {sleep 0.5; ....your example code goes here ...};</code> or no [[hintC]] will be displayed.
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 21:24, 2 September 2024

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 very basic message dialog in the center of the screen. Player control is taken away until "Continue" is pressed. The message dialog can be dragged around on the screen. After "Continue" has been pressed, the content of the hintC is repeated in a normal hint.
ⓘ
In Singleplayer, the game is paused while the message dialog is visible.
Groups:
InteractionStructured TextStrings

Syntax

Syntax:
hintC message
Parameters:
message: String
Return Value:
Nothing

Alternative Syntax

Syntax:
title hintC message
Parameters:
title: String - message title
message: String, Structured Text, Array of Strings or Array of Structured Text
Return Value:
Nothing

Examples

Example 1:
hintC "Press W to move forward";
Example 2:
Same as the above in Arma 3 but without second hint displayed:
HintC.jpg
hintC "Press W to move forward"; hintC_EH = findDisplay 57 displayAddEventHandler ["Unload", { _this spawn { _this select 0 displayRemoveEventHandler ["Unload", hintC_EH]; hintSilent ""; }; }];
Example 3:
"Instructions" hintC [ "Press W to move forward.", "Press S to move backwards.", "Use the mouse to turn right or left.", "Press V for weapon sights." ];
Example 4:
Same as the above in Arma 3 but without second hint displayed:
HintC array.jpg
"Instructions" hintC [ "Press W to move forward.", "Press S to move backwards.", "Use the mouse to turn right or left.", "Press V for weapon sights." ]; hintC_EH = findDisplay 72 displayAddEventHandler ["Unload", { _this spawn { _this select 0 displayRemoveEventHandler ["Unload", hintC_EH]; hintSilent ""; }; }];
Example 5:
private _separator = parseText "<br/>------------------------<br/>"; private _image = "\ca\ui\textures\aus_flag.paa"; private _message = composeText [image _image, "Heading Text", _separator, "Content"]; "" hintC _message;

Additional Information

See also:
hint hintCadet hintSilent BIS_fnc_guiMessage

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
Str - c
Posted on Jul 31, 2006 - 18:18 (UTC)
This command must be executed after mission start. If you place it into init.sqs or init field of some unit, it will not work. Just add a little delay (~0.001) and the place the command.
Worldeater - c
Posted on May 15, 2009 - 23:42 (UTC)
To display multiple messages after another you have to add a small delay in between. Otherwise only the first message will be displayed.
hintC "foo"; sleep 0.1; hintC "bar"
Without a sleep statement hintC will not suspend the script it has been called from.
Killzone_Kid - c
Posted on Mar 19, 2015 - 09:52 (UTC)
"Titled" hintC uses display #72 while "untitled" one uses display #57. If you are trying examples in Arma 3 debug console, add a little delay like this:
0 spawn { sleep 0.5; /* your example code goes here*/ };
or no hintC will be displayed.
Retrieved from "https://community.bistudio.com/wiki?title=hintC&oldid=369068"