createDiaryRecord: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|PARAMETER4= |p25=" to "|PARAMETER24= |p25=")
Line 6: Line 6:
|1.00|Game version=
|1.00|Game version=


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


| Creates a diary entry.
| Creates a diary entry. Supported tags and their parameters: <spoiler>
 
{{{!}} class{{=}}"bikitable sortable"
Supported tags and their parameters:
! Tag
* '''img'''
!class{{=}}"unsortable" {{!}} Options
** ''image'': [[String]] - path to image. When present, any element with it will be displayed as image.
{{!}}-
** ''width'': [[Number]] - image width in pixels.
{{!}} img
** ''height'': [[Number]] - image height in pixels.
{{!}}
* '''font'''
* ''image'': [[String]] - path to image. When present, any element with it will be displayed as image.
** ''color'': [[String]] - [http://en.wikipedia.org/wiki/HTML_color HTML color] in format #aarrggbb or #rrggbb
* ''width'': [[Number]] - image width in pixels.
** ''size'': [[Number]] - font height in pixels.
* ''height'': [[Number]] - image height in pixels.
** ''face'': [[String]] - font type (class from CfgFontFamilies)
{{!}}-
* '''br'''
{{!}} font
* '''marker'''
{{!}}
** ''name'': [[String]] - marker name
* ''color'': [[String]] - [http://en.wikipedia.org/wiki/HTML_color HTML color] in format #aarrggbb or #rrggbb
* '''execute'''
* ''size'': [[Number]] - font height in pixels.
** ''expression'': [[String]] - executed code
* ''face'': [[String]] - font type (class from CfgFontFamilies)
* '''executeClose'''
{{!}}-
** ''expression'': [[String]] - executed code, diary is closed afterwards
{{!}} br
* '''[[createDiaryLink|log]]'''
{{!}} -
** ''subject'': [[String]] - [[createDiarySubject|subject]] name.
{{!}}-
** ''record'': [[String]] - record name (e.g. "Record6" or "Unit1059524")
{{!}} marker
* '''gear'''
{{!}}
** ''unit'': [[Number]] - unit ID
* ''name'': [[String]] - marker name
* '''teamSwitch'''
{{!}}-
** ''unit'': [[Number]] - unit ID
{{!}} execute
* '''kick'''
{{!}}
** ''id'': [[Number]] - player ID
* ''expression'': [[String]] - executed code
* '''ban'''
{{!}}-
** ''id'': [[Number]] - player ID
{{!}} executeClose
* '''mute'''
{{!}}
** ''id'': [[Number]] - player ID
* ''expression'': [[String]] - executed code, diary is closed afterwards
* '''currentTask'''
{{!}}-
** ''id'': [[Number]] - task ID
{{!}} [[createDiaryLink|log]]
<br>
{{!}}
* ''subject'': [[String]] - [[createDiarySubject|subject]] name.
* ''record'': [[String]] - record name (e.g. "Record6" or "Unit1059524")
{{!}}-
{{!}} gear
{{!}}
* ''unit'': [[Number]] - unit ID
{{!}}-
{{!}} teamSwitch
{{!}}
* ''unit'': [[Number]] - unit ID
{{!}}-
{{!}} kick
{{!}}
* ''id'': [[Number]] - unit ID
{{!}}-
{{!}} ban
{{!}}
* ''id'': [[Number]] - unit ID
{{!}}-
{{!}} mute
{{!}}
* ''id'': [[Number]] - unit ID
{{!}}-
{{!}} currentTask
{{!}}
* ''id'': [[Number]] - task ID
{{!}}}</spoiler>
{{Informative | If [[createDiaryRecord]] command fails, it returns null record, but since there is no null record unary command, you can make a variable and compare against it.
{{Informative | If [[createDiaryRecord]] command fails, it returns null record, but since there is no null record unary command, you can make a variable and compare against it.
  [[private]] _nullRecord <nowiki>=</nowiki> [[objNull]] [[createDiaryRecord]] [];
  [[private]] _nullRecord <nowiki>=</nowiki> [[objNull]] [[createDiaryRecord]] [];
  [[if]] ([[player]] [[createDiaryRecord]] ["Diarea", ["title", "description"]] [[isEqualTo]] _nullRecord) [[then]] { [[hint]] "Failed" };
  [[if]] ([[player]] [[createDiaryRecord]] ["Diary", ["title", "description"]] [[isEqualTo]] _nullRecord) [[then]] { [[hint]] "Failed" };
}} |DESCRIPTION=
}} |DESCRIPTION=
____________________________________________________________________________________________
____________________________________________________________________________________________


| unitName '''createDiaryRecord''' [subject, text, task, taskState, showTitle] |SYNTAX=
| unitName [[createDiaryRecord]] [subject, text, task, taskState, showTitle] |SYNTAX=


|p1= unitName: [[Object]] |PARAMETER1=  
|p1= unitName: [[Object]] |PARAMETER1=  
|p2= [subject, text, task, state, showTitle]: [[Array]] |PARAMETER2=
 
|p3= subject: [[String]] |PARAMETER3=
|p2= subject: [[String]] |PARAMETER2=
|p4= text: [[String]] |PARAMETER4=
 
|p5= task: (optional): [[Task]] |PARAMETER5=
|p3= text: [[String]] |PARAMETER3=
|p6= taskState: (optional): [[String]] - Changes the state of the given task. Can be "CANCELED", "ASSIGNED", "FAILED", "CREATED", "SUCCEEDED"|PARAMETER6=
 
|p7= showTitle (Optional): [[Boolean]] - Title visibility. Default: [[true]] {{GVI|arma3|dev}} |PARAMETER6=
|p4= task: (optional): [[Task]] |PARAMETER4=
 
|p5= taskState: (optional): [[String]] - Changes the state of the given task. Can be "CANCELED", "ASSIGNED", "FAILED", "CREATED", "SUCCEEDED"|PARAMETER5=
 
|p6= showTitle (Optional): [[Boolean]] - Title visibility. Default: [[true]] {{GVI|arma3|dev}} |PARAMETER6=


| [[Diary Record]] |RETURNVALUE=
| [[Diary Record]] |RETURNVALUE=
____________________________________________________________________________________________


|s2= unitName [[createDiaryRecord]] [subject, [title, text], task, stateState, showTitle] |SYNTAX2=


|s2= unitName '''createDiaryRecord''' [subject, [title, text], task, stateState, showTitle] |SYNTAX2=
|p21= unitName: [[Object]] |PARAMETER21=


|p21= unitName: [[Object]] |PARAMETER21=
|p22= subject: [[String]] |PARAMETER22=
|p22= [subject, [title, text], task, state, showTitle]: [[Array]] |PARAMETER22=
 
|p23= subject: [[String]] |PARAMETER23=
|p23= title: [[String]] |PARAMETER23=
 
|p24= text: [[String]] |PARAMETER24=
 
|p25= task: (optional): [[Task]]|PARAMETER25=
 
|p26= taskState: (optional): [[String]] - Changes the state of the given task. Can be "CANCELED", "ASSIGNED", "FAILED", "CREATED", "SUCCEEDED" |PARAMETER26=
 
|p27= showTitle (Optional): [[Boolean]] - Title visibility. Default: [[true]] {{GVI|arma3|dev}} |PARAMETER27=
 
|r2= [[Diary Record]] |RETURNVALUE2=
____________________________________________________________________________________________
 
|x1= <code>[[player]] [[createDiaryRecord]] ["Diary", ["Intel", "Enemy base is on grid <nowiki><marker name='enemyBase'>161170</marker></nowiki>"]]</code>|EXAMPLE1=
 
|x2= <code>[[player]] [[createDiaryRecord]] ["Diary", "Information gathered.<nowiki><br />&lt;img image='wellDone_ca.paa' /&gt;</nowiki>"]</code>|EXAMPLE2=


|p24= [title, text]: [[Array]] |PARAMETER24=
|x3= <code>[[player]] [[createDiaryRecord]] ["Diary", ["No Title", "description"], [[taskNull]], "", [[false]]];</code>|EXAMPLE3=


|p25= title: [[String]] |PARAMETER25=
|x4= <code>[[player]] [[createDiaryRecord]] ["Diary", ["Font tag","<nowiki><font color='#7FFF00' size='30' face='TahomaB'>This will changed text size, colour and font</font></nowiki>"], [[taskNull]], "",[[false]]];</code>|EXAMPLE4=


|p26= text: [[String]] |PARAMETER6=
|x5= <code>[[player]] [[createDiaryRecord]] ["Diary", ["Image", "<nowiki><img image='\A3\Ui_F_Curator\Data\Logos\arma3_curator_artwork.jpg' width='500' height='800'/></nowiki>"], [[taskNull]], "", [[false]]];</code>|EXAMPLE5=
|p27= task: (optional): [[Task]]|PARAMETER7=
|p28= taskState: (optional): [[String]] - Changes the state of the given task. Can be "CANCELED", "ASSIGNED", "FAILED", "CREATED", "SUCCEEDED" |PARAMETER8=
|p29= showTitle (Optional): [[Boolean]] - Title visibility. Default: [[true]] {{GVI|arma3|dev}} |PARAMETER29=


|r2= [[Diary Record]] |RETURNVALUE=  
|x6= <code>[[player]] [[createDiaryRecord]] ["Diary", ["Linebreak","<nowiki>Line1<br></br>Line2<br></br><br></br>Line4</nowiki>"], [[taskNull]], "", [[false]]];</code>|EXAMPLE6=


|x7= <code>[[player]] [[createDiaryRecord]] ["Diary", ["Execute","<nowiki><execute expression='hint ""Some code"";'>Some text</execute></nowiki>"], [[taskNull]], "", [[false]]];</code>|EXAMPLE7=


|x1= <code>[[player]] [[createDiaryRecord]] ["Diary", ["Intel", "Enemy base is on grid <nowiki><marker name='enemyBase'>161170</marker></nowiki>"]]</code>|EXAMPLE1=
|x8= <code>[[player]] [[createDiaryRecord]] ["Diary", ["ExecuteClose", "<nowiki><executeClose expression=""hint 'Diary closed';"">Close Diary</executeClose></nowiki>"], [[taskNull]], "", [[false]]];</code>|EXAMPLE8=
|x2= <code>[[player]] [[createDiaryRecord]] ["Diary", "Information gathered.<nowiki><br />&lt;img image='wellDone_ca.paa' /&gt;</nowiki>"]</code>|EXAMPLE2=
|x3= <code>[[player]] [[createDiaryRecord]] ["Diary",["No Title","description"],[[taskNull]],"",[[false]]];</code>|EXAMPLE3=
|x4= <code>[[player]] [[createDiaryRecord]] ["Diary",["Font tag","<nowiki><font color='#7FFF00' size='30' face='TahomaB'>This will changed text size, colour and font</font></nowiki>"],[[taskNull]],"",[[false]]];</code>|EXAMPLE4=
|x5= <code>[[player]] [[createDiaryRecord]] ["Diary",["Image","<nowiki><img image='\A3\Ui_F_Curator\Data\Logos\arma3_curator_artwork.jpg' width='500' height='800'/></nowiki>"],[[taskNull]],"",[[false]]];</code>|EXAMPLE5=
|x6= <code>[[player]] [[createDiaryRecord]] ["Diary",["Linebreak","<nowiki>Line1<br></br>Line2<br></br><br></br>Line4</nowiki>"],[[taskNull]],"",[[false]]];</code>|EXAMPLE6=
|x7= <code>[[player]] [[createDiaryRecord]] ["Diary",["Execute","<nowiki><execute expression='hint ""Some code"";'>Some text</execute></nowiki>"],[[taskNull]],"",[[false]]];</code>|EXAMPLE7=
|x8= <code>[[player]] [[createDiaryRecord]] ["Diary",["ExecuteClose","<nowiki><executeClose expression=""hint 'Diary closed';"">Close Diary</executeClose></nowiki>"],[[taskNull]],"",[[false]]];</code>|EXAMPLE8=


| [[processDiaryLink]], [[createDiaryLink]], [[createDiarySubject]], [[diarySubjectExists]] |SEEALSO=  
| [[processDiaryLink]], [[createDiaryLink]], [[createDiarySubject]], [[diarySubjectExists]] |SEEALSO=


|  |MPBEHAVIOUR=  
|  |MPBEHAVIOUR=
____________________________________________________________________________________________
}}
}}



Revision as of 19:45, 3 September 2019

Hover & click on the images for description

Description

Description:
Creates a diary entry. Supported tags and their parameters:
Tag Options
img
  • image: String - path to image. When present, any element with it will be displayed as image.
  • width: Number - image width in pixels.
  • height: Number - image height in pixels.
font
  • color: String - HTML color in format #aarrggbb or #rrggbb
  • size: Number - font height in pixels.
  • face: String - font type (class from CfgFontFamilies)
br -
marker
execute
  • expression: String - executed code
executeClose
  • expression: String - executed code, diary is closed afterwards
log
gear
teamSwitch
kick
ban
mute
currentTask
↑ Back to spoiler's top
If createDiaryRecord command fails, it returns null record, but since there is no null record unary command, you can make a variable and compare against it.
private _nullRecord = objNull createDiaryRecord [];
if (player createDiaryRecord ["Diary", ["title", "description"]] isEqualTo _nullRecord) then { hint "Failed" };
Groups:
Uncategorised

Syntax

Syntax:
unitName createDiaryRecord [subject, text, task, taskState, showTitle]
Parameters:
unitName: Object
subject: String
text: String
task: (optional): Task
taskState: (optional): String - Changes the state of the given task. Can be "CANCELED", "ASSIGNED", "FAILED", "CREATED", "SUCCEEDED"
showTitle (Optional): Boolean - Title visibility. Default: true Arma 3 logo black.pngDEV
Return Value:
Diary Record

Alternative Syntax

Syntax:
unitName createDiaryRecord [subject, [title, text], task, stateState, showTitle]
Parameters:
unitName: Object
subject: String
title: String
text: String
task: (optional): Task
taskState: (optional): String - Changes the state of the given task. Can be "CANCELED", "ASSIGNED", "FAILED", "CREATED", "SUCCEEDED"
showTitle (Optional): Boolean - Title visibility. Default: true Arma 3 logo black.pngDEV
Return Value:
Diary Record

Examples

Example 1:
player createDiaryRecord ["Diary", ["Intel", "Enemy base is on grid <marker name='enemyBase'>161170</marker>"]]
Example 2:
player createDiaryRecord ["Diary", "Information gathered.<br /><img image='wellDone_ca.paa' />"]
Example 3:
player createDiaryRecord ["Diary", ["No Title", "description"], taskNull, "", false];
Example 4:
player createDiaryRecord ["Diary", ["Font tag","<font color='#7FFF00' size='30' face='TahomaB'>This will changed text size, colour and font</font>"], taskNull, "",false];
Example 5:
player createDiaryRecord ["Diary", ["Image", "<img image='\A3\Ui_F_Curator\Data\Logos\arma3_curator_artwork.jpg' width='500' height='800'/>"], taskNull, "", false];
Example 6:
player createDiaryRecord ["Diary", ["Linebreak","Line1<br></br>Line2<br></br><br></br>Line4"], taskNull, "", false];
Example 7:
player createDiaryRecord ["Diary", ["Execute","<execute expression='hint ""Some code"";'>Some text</execute>"], taskNull, "", false];
Example 8:
player createDiaryRecord ["Diary", ["ExecuteClose", "<executeClose expression=""hint 'Diary closed';"">Close Diary</executeClose>"], taskNull, "", false];

Additional Information

See also:
processDiaryLinkcreateDiaryLinkcreateDiarySubjectdiarySubjectExists

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

Bottom Section

Posted on March 24, 2017 - 20:11 (UTC)
Tankbuster
When adding multiple diary records, be aware that they appear in reverse order. ie the first one you add will appear last and the last one you add will be first.
Posted on May 21, 2018 - 08:21 (UTC)
Kalthramis
To add an entry under the 'Briefing' subject, which is available by default, use "Diary" as the subject.
Posted on June 22, 2019 - 16:28 (UTC)
R3vo
It seems that the task parameter has no effect because the task entry in the briefing menu is created when the task itself was created.