mirror of
https://gitlab.com/kelteseth/ScreenPlay.git
synced 2024-11-25 12:13:00 +01:00
168 lines
18 KiB
HTML
168 lines
18 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<!-- util.cpp -->
|
|
<title>Util Class | ScreenPlay</title>
|
|
<link rel="stylesheet" type="text/css" href="../css/style.css"/> <link rel="stylesheet" type="text/css" href="../css/bootstrap.min.css"/>
|
|
</head>
|
|
<body>
|
|
<div class="container-fullwidth nav sticky-top"><div class="container navWrapper"><a href="../index.html"><span class="logo">ScreenPlay Generated Docs </span></a><span class="navHome"><a href="../index.html">Home</a></span></div></div> <div id= mainWrapper class="wrapper container ">
|
|
<li>Util</li>
|
|
<div class="sidebar">
|
|
<div class="toc">
|
|
<h3><a name="toc">Contents</a></h3>
|
|
<ul>
|
|
<li class="level1"><a href="#public-functions">Public Functions</a></li>
|
|
<li class="level1"><a href="#public-slots">Public Slots</a></li>
|
|
<li class="level1"><a href="#signals">Signals</a></li>
|
|
<li class="level1"><a href="#details">Detailed Description</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="sidebar-content" id="sidebar-content"></div></div>
|
|
<h1 class="title">Util Class</h1>
|
|
<span class="small-subtitle">class <a href="screenplay.html">ScreenPlay</a>::Util</span>
|
|
<!-- $$$Util-brief -->
|
|
<p>Easy to use global object to use when certain functionality is not available in QML. <a href="#details">More...</a></p>
|
|
<!-- @@@Util -->
|
|
<div class="table"><table class="alignedsummary">
|
|
<tr><td class="memItemLeft rightAlign topAlign"> Header:</td><td class="memItemRight bottomAlign"> <span class="preprocessor">#include <Util></span>
|
|
</td></tr></table></div><ul>
|
|
<li><a href="screenplay-util-members.html">List of all members, including inherited members</a></li>
|
|
</ul>
|
|
<a name="public-functions"></a>
|
|
<h2 id="public-functions">Public Functions</h2>
|
|
<div class="table"><table class="alignedsummary">
|
|
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#Util">Util</a></b>(QNetworkAccessManager *<i>networkAccessManager</i>, QObject *<i>parent</i> = nullptr)</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#debugMessages-prop">debugMessages</a></b>() const</td></tr>
|
|
</table></div>
|
|
<a name="public-slots"></a>
|
|
<h2 id="public-slots">Public Slots</h2>
|
|
<div class="table"><table class="alignedsummary">
|
|
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#copyPreviewThumbnail">copyPreviewThumbnail</a></b>(QJsonObject &<i>obj</i>, const QString &<i>name</i>, const QString &<i>destination</i>)</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#copyToClipboard">copyToClipboard</a></b>(const QString &<i>text</i>) const</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> QJsonArray </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#fillArray">fillArray</a></b>(const QVector<QString> &<i>items</i>)</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#generateRandomString">generateRandomString</a></b>(quint32 <i>length</i> = 32)</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> std::optional<InstalledType::InstalledType> </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#getInstalledTypeFromString">getInstalledTypeFromString</a></b>(const QString &<i>type</i>)</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> SearchType::SearchType </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#getSearchTypeFromInstalledType">getSearchTypeFromInstalledType</a></b>(const InstalledType::InstalledType <i>type</i>)</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> std::optional<QVersionNumber> </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#getVersionNumberFromString">getVersionNumberFromString</a></b>(const QString &<i>str</i>)</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#logToGui">logToGui</a></b>(QtMsgType <i>type</i>, const QMessageLogContext &<i>context</i>, const QString &<i>msg</i>)</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#openFolderInExplorer">openFolderInExplorer</a></b>(const QString &<i>url</i>) const</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> std::optional<QJsonObject> </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#openJsonFileToObject">openJsonFileToObject</a></b>(const QString &<i>path</i>)</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> std::optional<QString> </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#openJsonFileToString">openJsonFileToString</a></b>(const QString &<i>path</i>)</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> std::optional<QJsonObject> </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#parseQByteArrayToQJsonObject">parseQByteArrayToQJsonObject</a></b>(const QByteArray &<i>byteArray</i>)</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#requestAllLicenses">requestAllLicenses</a></b>()</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#requestDataProtection">requestDataProtection</a></b>()</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#toLocal">toLocal</a></b>(const QString &<i>url</i>)</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#toString">toString</a></b>(const QStringList &<i>list</i>)</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#writeFile">writeFile</a></b>(const QString &<i>text</i>, const QString &<i>absolutePath</i>)</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#writeFileFromQrc">writeFileFromQrc</a></b>(const QString &<i>qrcPath</i>, const QString &<i>absolutePath</i>)</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#writeJsonObjectToFile">writeJsonObjectToFile</a></b>(const QString &<i>absoluteFilePath</i>, const QJsonObject &<i>object</i>, bool <i>truncate</i> = true)</td></tr>
|
|
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#writeSettings">writeSettings</a></b>(const QJsonObject &<i>obj</i>, const QString &<i>absolutePath</i>)</td></tr>
|
|
</table></div>
|
|
<a name="signals"></a>
|
|
<h2 id="signals">Signals</h2>
|
|
<div class="table"><table class="alignedsummary">
|
|
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="screenplay-util.html#debugMessages-prop">debugMessagesChanged</a></b>(QString <i>debugMessages</i>)</td></tr>
|
|
</table></div>
|
|
<a name="details"></a>
|
|
<!-- $$$Util-description -->
|
|
<div class="descr">
|
|
<h2 id="details">Detailed Description</h2>
|
|
</div>
|
|
<!-- @@@Util -->
|
|
<div class="func">
|
|
<h2>Member Function Documentation</h2>
|
|
<!-- $$$Util[overload1]$$$UtilQNetworkAccessManager*QObject* -->
|
|
<h3 class="fn" id="Util"><a name="Util"></a>Util::<span class="name">Util</span>(<span class="type">QNetworkAccessManager</span> *<i>networkAccessManager</i>, <span class="type">QObject</span> *<i>parent</i> = nullptr)</h3>
|
|
<p>Constructor.</p>
|
|
<!-- @@@Util -->
|
|
<!-- $$$copyPreviewThumbnail[overload1]$$$copyPreviewThumbnailQJsonObject&constQString&constQString& -->
|
|
<h3 class="fn" id="copyPreviewThumbnail"><a name="copyPreviewThumbnail"></a><code>[static slot] </code><span class="type">bool</span> Util::<span class="name">copyPreviewThumbnail</span>(<span class="type">QJsonObject</span> &<i>obj</i>, const <span class="type">QString</span> &<i>name</i>, const <span class="type">QString</span> &<i>destination</i>)</h3>
|
|
<p>Takes reference to <i>obj</i>. If the copy of the thumbnail is successful, it adds the corresponding settings entry to the json object reference.</p>
|
|
<!-- @@@copyPreviewThumbnail -->
|
|
<!-- $$$copyToClipboard[overload1]$$$copyToClipboardconstQString& -->
|
|
<h3 class="fn" id="copyToClipboard"><a name="copyToClipboard"></a><code>[slot] </code><span class="type">void</span> Util::<span class="name">copyToClipboard</span>(const <span class="type">QString</span> &<i>text</i>) const</h3>
|
|
<p>Copies the given string to the clipboard.</p>
|
|
<!-- @@@copyToClipboard -->
|
|
<!-- $$$fillArray[overload1]$$$fillArrayconstQVector<QString>& -->
|
|
<h3 class="fn" id="fillArray"><a name="fillArray"></a><code>[static slot] </code><span class="type">QJsonArray</span> Util::<span class="name">fillArray</span>(const <span class="type">QVector</span><<span class="type">QString</span>> &<i>items</i>)</h3>
|
|
<p>Util function that converts a QVector of Strings into a QJsonArray.</p>
|
|
<!-- @@@fillArray -->
|
|
<!-- $$$generateRandomString[overload1]$$$generateRandomStringquint32 -->
|
|
<h3 class="fn" id="generateRandomString"><a name="generateRandomString"></a><code>[static slot] </code><span class="type">QString</span> Util::<span class="name">generateRandomString</span>(<span class="type">quint32</span> <i>length</i> = 32)</h3>
|
|
<p>Generates a (non secure) random string with the default length of 32. Can contain:</p>
|
|
<ul>
|
|
<li>A-Z</li>
|
|
<li>a-z</li>
|
|
<li>0-9</li>
|
|
</ul>
|
|
<!-- @@@generateRandomString -->
|
|
<!-- $$$getInstalledTypeFromString[overload1]$$$getInstalledTypeFromStringconstQString& -->
|
|
<h3 class="fn" id="getInstalledTypeFromString"><a name="getInstalledTypeFromString"></a><code>[static slot] </code><span class="type">std::optional</span><<span class="type">InstalledType::InstalledType</span>> Util::<span class="name">getInstalledTypeFromString</span>(const <span class="type">QString</span> &<i>type</i>)</h3>
|
|
<p>Maps the installed type from a QString to an enum. Used for parsing the project.json.</p>
|
|
<!-- @@@getInstalledTypeFromString -->
|
|
<!-- $$$getSearchTypeFromInstalledType[overload1]$$$getSearchTypeFromInstalledTypeconstInstalledType::InstalledType -->
|
|
<h3 class="fn" id="getSearchTypeFromInstalledType"><a name="getSearchTypeFromInstalledType"></a><code>[static slot] </code><span class="type">SearchType::SearchType</span> Util::<span class="name">getSearchTypeFromInstalledType</span>(const <span class="type">InstalledType::InstalledType</span> <i>type</i>)</h3>
|
|
<p>Maps the Search type to an installed type. Used for filtering the installed content.</p>
|
|
<!-- @@@getSearchTypeFromInstalledType -->
|
|
<!-- $$$getVersionNumberFromString[overload1]$$$getVersionNumberFromStringconstQString& -->
|
|
<h3 class="fn" id="getVersionNumberFromString"><a name="getVersionNumberFromString"></a><code>[static slot] </code><span class="type">std::optional</span><<span class="type">QVersionNumber</span>> Util::<span class="name">getVersionNumberFromString</span>(const <span class="type">QString</span> &<i>str</i>)</h3>
|
|
<p>Parses a version from a given QString. The QString must be looke like this: 1.0.0 - Major.Minor.Patch. A fixed position is used for parsing (at 0,2,4). Return std::nullopt when not successful.</p>
|
|
<!-- @@@getVersionNumberFromString -->
|
|
<!-- $$$logToGui[overload1]$$$logToGuiQtMsgTypeconstQMessageLogContext&constQString& -->
|
|
<h3 class="fn" id="logToGui"><a name="logToGui"></a><code>[static slot] </code><span class="type">void</span> Util::<span class="name">logToGui</span>(<span class="type">QtMsgType</span> <i>type</i>, const <span class="type">QMessageLogContext</span> &<i>context</i>, const <span class="type">QString</span> &<i>msg</i>)</h3>
|
|
<p>Basic logging to the GUI. No logging is done to a log file for now. This string can be copied in the settings tab in the UI.</p>
|
|
<!-- @@@logToGui -->
|
|
<!-- $$$openFolderInExplorer[overload1]$$$openFolderInExplorerconstQString& -->
|
|
<h3 class="fn" id="openFolderInExplorer"><a name="openFolderInExplorer"></a><code>[slot] </code><span class="type">void</span> Util::<span class="name">openFolderInExplorer</span>(const <span class="type">QString</span> &<i>url</i>) const</h3>
|
|
<p>Opens a native folder window on the given path. Windows and Mac only for now!</p>
|
|
<!-- @@@openFolderInExplorer -->
|
|
<!-- $$$openJsonFileToObject[overload1]$$$openJsonFileToObjectconstQString& -->
|
|
<h3 class="fn" id="openJsonFileToObject"><a name="openJsonFileToObject"></a><code>[static slot] </code><span class="type">std::optional</span><<span class="type">QJsonObject</span>> Util::<span class="name">openJsonFileToObject</span>(const <span class="type">QString</span> &<i>path</i>)</h3>
|
|
<p>Opens a json file (absolute path) and tries to convert it to a QJsonObject. Returns std::nullopt when not successful.</p>
|
|
<!-- @@@openJsonFileToObject -->
|
|
<!-- $$$openJsonFileToString[overload1]$$$openJsonFileToStringconstQString& -->
|
|
<h3 class="fn" id="openJsonFileToString"><a name="openJsonFileToString"></a><code>[static slot] </code><span class="type">std::optional</span><<span class="type">QString</span>> Util::<span class="name">openJsonFileToString</span>(const <span class="type">QString</span> &<i>path</i>)</h3>
|
|
<p>Opens a json file (absolute path) and tries to convert it to a QString. Returns std::nullopt when not successful.</p>
|
|
<!-- @@@openJsonFileToString -->
|
|
<!-- $$$parseQByteArrayToQJsonObject[overload1]$$$parseQByteArrayToQJsonObjectconstQByteArray& -->
|
|
<h3 class="fn" id="parseQByteArrayToQJsonObject"><a name="parseQByteArrayToQJsonObject"></a><code>[static slot] </code><span class="type">std::optional</span><<span class="type">QJsonObject</span>> Util::<span class="name">parseQByteArrayToQJsonObject</span>(const <span class="type">QByteArray</span> &<i>byteArray</i>)</h3>
|
|
<p>Parses a QByteArray to a QJsonObject. If returns and std::nullopt on failure.</p>
|
|
<!-- @@@parseQByteArrayToQJsonObject -->
|
|
<!-- $$$requestAllLicenses[overload1]$$$requestAllLicenses -->
|
|
<h3 class="fn" id="requestAllLicenses"><a name="requestAllLicenses"></a><code>[slot] </code><span class="type">void</span> Util::<span class="name">requestAllLicenses</span>()</h3>
|
|
<p>Loads all content of the legal folder in the qrc into a property string of this class. allLicenseLoaded is emited when loading is finished.</p>
|
|
<!-- @@@requestAllLicenses -->
|
|
<!-- $$$requestDataProtection[overload1]$$$requestDataProtection -->
|
|
<h3 class="fn" id="requestDataProtection"><a name="requestDataProtection"></a><code>[slot] </code><span class="type">void</span> Util::<span class="name">requestDataProtection</span>()</h3>
|
|
<p>Loads all dataprotection of the legal folder in the qrc into a property string of this class. allDataProtectionLoaded is emited when loading is finished.</p>
|
|
<!-- @@@requestDataProtection -->
|
|
<!-- $$$toLocal[overload1]$$$toLocalconstQString& -->
|
|
<h3 class="fn" id="toLocal"><a name="toLocal"></a><code>[static slot] </code><span class="type">QString</span> Util::<span class="name">toLocal</span>(const <span class="type">QString</span> &<i>url</i>)</h3>
|
|
<p>Converts the given <i>url</i> string to a local file path.</p>
|
|
<!-- @@@toLocal -->
|
|
<!-- $$$toString[overload1]$$$toStringconstQStringList& -->
|
|
<h3 class="fn" id="toString"><a name="toString"></a><code>[static slot] </code><span class="type">QString</span> Util::<span class="name">toString</span>(const <span class="type">QStringList</span> &<i>list</i>)</h3>
|
|
<p>Helper function to append a QStringList into a QString with a space between the items.</p>
|
|
<!-- @@@toString -->
|
|
<!-- $$$writeFile[overload1]$$$writeFileconstQString&constQString& -->
|
|
<h3 class="fn" id="writeFile"><a name="writeFile"></a><code>[static slot] </code><span class="type">bool</span> Util::<span class="name">writeFile</span>(const <span class="type">QString</span> &<i>text</i>, const <span class="type">QString</span> &<i>absolutePath</i>)</h3>
|
|
<p>Tries to save into a text file with absolute path.</p>
|
|
<!-- @@@writeFile -->
|
|
<!-- $$$writeFileFromQrc[overload1]$$$writeFileFromQrcconstQString&constQString& -->
|
|
<h3 class="fn" id="writeFileFromQrc"><a name="writeFileFromQrc"></a><code>[static slot] </code><span class="type">bool</span> Util::<span class="name">writeFileFromQrc</span>(const <span class="type">QString</span> &<i>qrcPath</i>, const <span class="type">QString</span> &<i>absolutePath</i>)</h3>
|
|
<p>Tries to save into a text file with absolute path.</p>
|
|
<!-- @@@writeFileFromQrc -->
|
|
<!-- $$$writeJsonObjectToFile[overload1]$$$writeJsonObjectToFileconstQString&constQJsonObject&bool -->
|
|
<h3 class="fn" id="writeJsonObjectToFile"><a name="writeJsonObjectToFile"></a><code>[static slot] </code><span class="type">bool</span> Util::<span class="name">writeJsonObjectToFile</span>(const <span class="type">QString</span> &<i>absoluteFilePath</i>, const <span class="type">QJsonObject</span> &<i>object</i>, <span class="type">bool</span> <i>truncate</i> = true)</h3>
|
|
<p>Writes a given QJsonObject to a file. The path must be absolute. When truncate is set to true the exsisting json file will be overriten.</p>
|
|
<!-- @@@writeJsonObjectToFile -->
|
|
<!-- $$$writeSettings[overload1]$$$writeSettingsconstQJsonObject&constQString& -->
|
|
<h3 class="fn" id="writeSettings"><a name="writeSettings"></a><code>[static slot] </code><span class="type">bool</span> Util::<span class="name">writeSettings</span>(const <span class="type">QJsonObject</span> &<i>obj</i>, const <span class="type">QString</span> &<i>absolutePath</i>)</h3>
|
|
<p>Takes ownership of <i>obj</i> and <i>name</i>. Tries to save into a text file with of name.</p>
|
|
<!-- @@@writeSettings -->
|
|
</div>
|
|
<div id= license class="footer center"><p>This documentation is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 International License</a>.</p></div> <script src="../js/bootstrap.bundle.min.js"></script> <script src="../js/mermaid.min.js"></script> <script>var config = {startOnLoad:true,flowchart:{useMaxWidth:true,htmlLabels:true}};mermaid.initialize(config);</script></body>
|
|
</html>
|