BIS fnc showAANArticle: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "^ \{\{(Command|Function)" to "{{$1")
m (Text replacement - "\[ +" to "[")
 
(18 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Function|Comments=
{{RV|type=function


| arma3 |Game name=
|game1= arma3
|version1= 1.76


| 1.76 |Game version=
|gr1= GUI


|gr1 = GUI |GROUP1=
|gr2= Interaction


|gr2 = Interaction |GROUP2=
|descr= Show an AAN article.


| Show AAN article |DESCRIPTION=
|s1= [arrayOfArrays, display, fade] call [[BIS_fnc_showAANArticle]]
 
| [arrayOfArrays, display, fade] call [[BIS_fnc_showAANArticle]] |SYNTAX=


|p1= arrayOfArrays: [[Array|array]] of [[Array|arrays]]; each subarray defines part of an article, can be:
|p1= arrayOfArrays: [[Array|array]] of [[Array|arrays]]; each subarray defines part of an article, can be:
*Article title: ["title", <text:string>]
* Article title: ["title", <text:string>]
*Article author and date: ["meta", [<author:string>, <date:array Y,M,D,H,M>, <timezoneName:string>]]
* Article author and date: ["meta", [<author:string>, <date:array Y,M,D,H,M>, <timezoneName:string>]]
*Paragraph: ["text",<text:string>]
* Paragraph: ["text",<text:string>]
*Bold paragraph: ["textbold",<text:string>]
* Bold paragraph: ["textbold",<text:string>]
*Locked paragraph: ["textlocked",[<text:string>,<prompt:string>]] - ''Locked paragraph with subscriber prompt. There should be no paragraph after it.''
* Locked paragraph: ["textlocked",[<text:string>,<prompt:string>]] - ''Locked paragraph with subscriber prompt. There should be no paragraph after it.''
*Image with description: ["image", [<path:string>, <description:string>, <source:string>]] - ''The image should have 2:1 ratio.''
* Image with description: ["image", [<path:string>, <description:string>, <source:string>]] - ''The image should have 2:1 ratio.''
*Link to another "fake" article displayed on left: ["box",[<path:string>, <description:string>]] - ''The image should have 2:1 ratio.''
* Link to another "fake" article displayed on left: ["box",[<path:string>, <description:string>]] - ''The image should have 2:1 ratio.''
*Author's bio: ["author",[<path:string>, <description:string>]] - ''The image should have 1:1 ratio.''
* Author's bio: ["author",[<path:string>, <description:string>]] - ''The image should have 1:1 ratio.''
*Draft notification: ["draft",[<text:string>, <color:arrayRGB>]] - ''Text and color are optional, default notification will be shown when they're undefined.''
* Draft notification: ["draft",[<text:string>, <color:arrayRGB>]] - ''Text and color are optional, default notification will be shown when they're undefined.''
|PARAMETER1=


|p2= display: a [[Display|display]] to make the AAN article a child of it |PARAMETER2=
|p2= display: [[Display]] - a display to make the AAN article a child of it


|p3= fade: [[Boolean]] (default: false) true to fade from black |PARAMETER3=
|p3= fade: [[Boolean]] - (Optional, default false) true to fade from black


| [[Display]] - the AAN article display |RETURNVALUE=
|r1= [[Display]] - the AAN article display


|x1= <pre>
|x1= [[File:a3 orange aan.jpg|thumb|480px|Result]]
[  
<sqf>
[  
[
[
["title","My Title"],  
["title","My Title"],  
["meta",["Katherine Bishop",[2035,2,24,11,38],"CET"]],  
["meta",["Katherine Bishop",[2035,2,24,11,38],"CET"]],  
Line 43: Line 42:
["author",["\a3\Missions_F_Orange\Data\Img\avatar_journalist_ca.paa","Katherine Bishop is a journalist"]]  
["author",["\a3\Missions_F_Orange\Data\Img\avatar_journalist_ca.paa","Katherine Bishop is a journalist"]]  
]
]
] call bis_fnc_showAANArticle;
] call BIS_fnc_showAANArticle;
</pre>
</sqf>
 
'''Result:'''
 
[[File:a3 orange aan.jpg|480px]]


|seealso= [[BIS_fnc_AAN]]
}}


| [[BIS_fnc_AAN]] |SEEALSO=
{{Note
|user= Freddo3000
|timestamp= 20210612234200
|text= Can be added to [[Diary Record|diary records]] using an {{hl|&lt;expression&gt;}} tag, with a clickable link leading to the article.
<sqf>
TAG_fnc_myArticle = {
[
[
["title", "My Article"],
["text", "Flavour text"]
]
] call BIS_fnc_showAANArticle
};


player createDiaryRecord ["diary", ["articles", "<execute expression='[] call TAG_fnc_myArticle'>My Article 1</execute>"]];
</sqf>
}}
}}
<h3 style="display:none">Bottom Section</h3>
[[Category:Functions|{{uc:showAANArticle}}]]
[[Category:{{Name|arma3}}: Functions|{{uc:showAANArticle}}]]

Latest revision as of 18:16, 8 November 2023

Hover & click on the images for description

Description

Description:
Show an AAN article.
Execution:
call
Groups:
GUIInteraction

Syntax

Syntax:
[arrayOfArrays, display, fade] call BIS_fnc_showAANArticle
Parameters:
arrayOfArrays: array of arrays; each subarray defines part of an article, can be:
  • Article title: ["title", <text:string>]
  • Article author and date: ["meta", [<author:string>, <date:array Y,M,D,H,M>, <timezoneName:string>]]
  • Paragraph: ["text",<text:string>]
  • Bold paragraph: ["textbold",<text:string>]
  • Locked paragraph: ["textlocked",[<text:string>,<prompt:string>]] - Locked paragraph with subscriber prompt. There should be no paragraph after it.
  • Image with description: ["image", [<path:string>, <description:string>, <source:string>]] - The image should have 2:1 ratio.
  • Link to another "fake" article displayed on left: ["box",[<path:string>, <description:string>]] - The image should have 2:1 ratio.
  • Author's bio: ["author",[<path:string>, <description:string>]] - The image should have 1:1 ratio.
  • Draft notification: ["draft",[<text:string>, <color:arrayRGB>]] - Text and color are optional, default notification will be shown when they're undefined.
display: Display - a display to make the AAN article a child of it
fade: Boolean - (Optional, default false) true to fade from black
Return Value:
Display - the AAN article display

Examples

Example 1:
Result
[ [ ["title","My Title"], ["meta",["Katherine Bishop",[2035,2,24,11,38],"CET"]], ["textbold","This is a bold text"], ["image",["\a3\Missions_F_Orange\Data\Img\orange_overview_ca.paa","Some image description"]], ["box",["\a3\Missions_F_Orange\Data\Img\Faction_IDAP_overview_CA.paa","You won't believe how playing Showcase Laws of War can change your life!"]], ["text","Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi tincidunt pretium ultricies. Etiam ac ornare est, quis posuere nisl. Mauris facilisis lectus eu turpis maximus consequat. Donec ut metus nec risus tristique mattis. Ut posuere rutrum tellus, ut molestie orci mattis id. Cras ultrices euismod diam, in venenatis nunc commodo eget. Interdum et malesuada fames ac ante ipsum primis in faucibus. Morbi congue dolor rutrum lectus euismod, ac faucibus magna molestie. Aliquam in libero sit amet eros sagittis tristique. Nam pellentesque dignissim aliquam."], ["textlocked",["Sed non est risus. Nulla condimentum at leo sed bibendum. Phasellus laoreet sit amet leo tincidunt consequat. Curabitur nec hendrerit purus. Nam massa nisi, mattis in aliquet consectetur, ornare eget nibh. Nunc dignissim, nibh sit amet ultrices tincidunt, mi nulla fermentum quam, non condimentum dolor eros vulputate massa.","SUBSCRIBE PLZ"]], ["author",["\a3\Missions_F_Orange\Data\Img\avatar_journalist_ca.paa","Katherine Bishop is a journalist"]] ] ] call BIS_fnc_showAANArticle;

Additional Information

See also:
BIS_fnc_AAN

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
Freddo3000 - c
Posted on Jun 12, 2021 - 23:42 (UTC)
Can be added to diary records using an <expression> tag, with a clickable link leading to the article.
TAG_fnc_myArticle = { [ [ ["title", "My Article"], ["text", "Flavour text"] ] ] call BIS_fnc_showAANArticle }; player createDiaryRecord ["diary", ["articles", "<execute expression='[] call TAG_fnc_myArticle'>My Article 1</execute>"]];