git repos / PlatformFolders

blame: html/doxygen/4.0.0/namespacesago.html

normal view · raw

7e54d64b sago007 2018-06-24 15:21 1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
7e54d64b sago007 2018-06-24 15:21 2
<html xmlns="http://www.w3.org/1999/xhtml">
7e54d64b sago007 2018-06-24 15:21 3
<head>
7e54d64b sago007 2018-06-24 15:21 4
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
7e54d64b sago007 2018-06-24 15:21 5
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
7e54d64b sago007 2018-06-24 15:21 6
<meta name="generator" content="Doxygen 1.8.13"/>
7e54d64b sago007 2018-06-24 15:21 7
<meta name="viewport" content="width=device-width, initial-scale=1"/>
7e54d64b sago007 2018-06-24 15:21 8
<title>Platform folders: sago Namespace Reference</title>
7e54d64b sago007 2018-06-24 15:21 9
<link href="tabs.css" rel="stylesheet" type="text/css"/>
7e54d64b sago007 2018-06-24 15:21 10
<script type="text/javascript" src="jquery.js"></script>
7e54d64b sago007 2018-06-24 15:21 11
<script type="text/javascript" src="dynsections.js"></script>
7e54d64b sago007 2018-06-24 15:21 12
<link href="search/search.css" rel="stylesheet" type="text/css"/>
7e54d64b sago007 2018-06-24 15:21 13
<script type="text/javascript" src="search/searchdata.js"></script>
7e54d64b sago007 2018-06-24 15:21 14
<script type="text/javascript" src="search/search.js"></script>
7e54d64b sago007 2018-06-24 15:21 15
<link href="doxygen.css" rel="stylesheet" type="text/css" />
7e54d64b sago007 2018-06-24 15:21 16
</head>
7e54d64b sago007 2018-06-24 15:21 17
<body>
7e54d64b sago007 2018-06-24 15:21 18
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
7e54d64b sago007 2018-06-24 15:21 19
<div id="titlearea">
7e54d64b sago007 2018-06-24 15:21 20
<table cellspacing="0" cellpadding="0">
7e54d64b sago007 2018-06-24 15:21 21
 <tbody>
7e54d64b sago007 2018-06-24 15:21 22
 <tr style="height: 56px;">
7e54d64b sago007 2018-06-24 15:21 23
  <td id="projectalign" style="padding-left: 0.5em;">
7e54d64b sago007 2018-06-24 15:21 24
   <div id="projectname">Platform folders
7e54d64b sago007 2018-06-24 15:21 25
   &#160;<span id="projectnumber">4.0.0</span>
7e54d64b sago007 2018-06-24 15:21 26
   </div>
7e54d64b sago007 2018-06-24 15:21 27
  </td>
7e54d64b sago007 2018-06-24 15:21 28
 </tr>
7e54d64b sago007 2018-06-24 15:21 29
 </tbody>
7e54d64b sago007 2018-06-24 15:21 30
</table>
7e54d64b sago007 2018-06-24 15:21 31
</div>
7e54d64b sago007 2018-06-24 15:21 32
<!-- end header part -->
7e54d64b sago007 2018-06-24 15:21 33
<!-- Generated by Doxygen 1.8.13 -->
7e54d64b sago007 2018-06-24 15:21 34
<script type="text/javascript">
7e54d64b sago007 2018-06-24 15:21 35
var searchBox = new SearchBox("searchBox", "search",false,'Search');
7e54d64b sago007 2018-06-24 15:21 36
</script>
7e54d64b sago007 2018-06-24 15:21 37
<script type="text/javascript" src="menudata.js"></script>
7e54d64b sago007 2018-06-24 15:21 38
<script type="text/javascript" src="menu.js"></script>
7e54d64b sago007 2018-06-24 15:21 39
<script type="text/javascript">
7e54d64b sago007 2018-06-24 15:21 40
$(function() {
7e54d64b sago007 2018-06-24 15:21 41
  initMenu('',true,false,'search.php','Search');
7e54d64b sago007 2018-06-24 15:21 42
  $(document).ready(function() { init_search(); });
7e54d64b sago007 2018-06-24 15:21 43
});
7e54d64b sago007 2018-06-24 15:21 44
</script>
7e54d64b sago007 2018-06-24 15:21 45
<div id="main-nav"></div>
7e54d64b sago007 2018-06-24 15:21 46
<!-- window showing the filter options -->
7e54d64b sago007 2018-06-24 15:21 47
<div id="MSearchSelectWindow"
7e54d64b sago007 2018-06-24 15:21 48
     onmouseover="return searchBox.OnSearchSelectShow()"
7e54d64b sago007 2018-06-24 15:21 49
     onmouseout="return searchBox.OnSearchSelectHide()"
7e54d64b sago007 2018-06-24 15:21 50
     onkeydown="return searchBox.OnSearchSelectKey(event)">
7e54d64b sago007 2018-06-24 15:21 51
</div>
7e54d64b sago007 2018-06-24 15:21 52
7e54d64b sago007 2018-06-24 15:21 53
<!-- iframe showing the search results (closed by default) -->
7e54d64b sago007 2018-06-24 15:21 54
<div id="MSearchResultsWindow">
7e54d64b sago007 2018-06-24 15:21 55
<iframe src="javascript:void(0)" frameborder="0" 
7e54d64b sago007 2018-06-24 15:21 56
        name="MSearchResults" id="MSearchResults">
7e54d64b sago007 2018-06-24 15:21 57
</iframe>
7e54d64b sago007 2018-06-24 15:21 58
</div>
7e54d64b sago007 2018-06-24 15:21 59
7e54d64b sago007 2018-06-24 15:21 60
</div><!-- top -->
7e54d64b sago007 2018-06-24 15:21 61
<div class="header">
7e54d64b sago007 2018-06-24 15:21 62
  <div class="summary">
7e54d64b sago007 2018-06-24 15:21 63
<a href="#func-members">Functions</a>  </div>
7e54d64b sago007 2018-06-24 15:21 64
  <div class="headertitle">
7e54d64b sago007 2018-06-24 15:21 65
<div class="title">sago Namespace Reference</div>  </div>
7e54d64b sago007 2018-06-24 15:21 66
</div><!--header-->
7e54d64b sago007 2018-06-24 15:21 67
<div class="contents">
7e54d64b sago007 2018-06-24 15:21 68
<table class="memberdecls">
7e54d64b sago007 2018-06-24 15:21 69
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
7e54d64b sago007 2018-06-24 15:21 70
Functions</h2></td></tr>
7e54d64b sago007 2018-06-24 15:21 71
<tr class="memitem:a85c382a039426b76aa408961ac2149ee"><td class="memItemLeft" align="right" valign="top">std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#a85c382a039426b76aa408961ac2149ee">getDataHome</a> ()</td></tr>
7e54d64b sago007 2018-06-24 15:21 72
<tr class="separator:a85c382a039426b76aa408961ac2149ee"><td class="memSeparator" colspan="2">&#160;</td></tr>
7e54d64b sago007 2018-06-24 15:21 73
<tr class="memitem:aa6c6da4e6fe460076ac069e176622f59"><td class="memItemLeft" align="right" valign="top">std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#aa6c6da4e6fe460076ac069e176622f59">getConfigHome</a> ()</td></tr>
7e54d64b sago007 2018-06-24 15:21 74
<tr class="separator:aa6c6da4e6fe460076ac069e176622f59"><td class="memSeparator" colspan="2">&#160;</td></tr>
7e54d64b sago007 2018-06-24 15:21 75
<tr class="memitem:a426458c0e30383f23ecab17bdf55a407"><td class="memItemLeft" align="right" valign="top">std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#a426458c0e30383f23ecab17bdf55a407">getCacheDir</a> ()</td></tr>
7e54d64b sago007 2018-06-24 15:21 76
<tr class="separator:a426458c0e30383f23ecab17bdf55a407"><td class="memSeparator" colspan="2">&#160;</td></tr>
7e54d64b sago007 2018-06-24 15:21 77
<tr class="memitem:a2d3b0d91188997c4949f5f39a24dd8ab"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#a2d3b0d91188997c4949f5f39a24dd8ab">appendAdditionalDataDirectories</a> (std::vector&lt; std::string &gt; &amp;homes)</td></tr>
7e54d64b sago007 2018-06-24 15:21 78
<tr class="separator:a2d3b0d91188997c4949f5f39a24dd8ab"><td class="memSeparator" colspan="2">&#160;</td></tr>
7e54d64b sago007 2018-06-24 15:21 79
<tr class="memitem:a760a4d546d0bccc82dc939ed6e10304d"><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#a760a4d546d0bccc82dc939ed6e10304d">appendAdditionalConfigDirectories</a> (std::vector&lt; std::string &gt; &amp;homes)</td></tr>
7e54d64b sago007 2018-06-24 15:21 80
<tr class="separator:a760a4d546d0bccc82dc939ed6e10304d"><td class="memSeparator" colspan="2">&#160;</td></tr>
7e54d64b sago007 2018-06-24 15:21 81
<tr class="memitem:ac9fc8e0a8f97b7066548223d43720ce8"><td class="memItemLeft" align="right" valign="top">std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#ac9fc8e0a8f97b7066548223d43720ce8">getDesktopFolder</a> ()</td></tr>
7e54d64b sago007 2018-06-24 15:21 82
<tr class="separator:ac9fc8e0a8f97b7066548223d43720ce8"><td class="memSeparator" colspan="2">&#160;</td></tr>
7e54d64b sago007 2018-06-24 15:21 83
<tr class="memitem:aa44dc2057a9acdb38a10e41a60b7bb82"><td class="memItemLeft" align="right" valign="top">std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#aa44dc2057a9acdb38a10e41a60b7bb82">getDocumentsFolder</a> ()</td></tr>
7e54d64b sago007 2018-06-24 15:21 84
<tr class="separator:aa44dc2057a9acdb38a10e41a60b7bb82"><td class="memSeparator" colspan="2">&#160;</td></tr>
7e54d64b sago007 2018-06-24 15:21 85
<tr class="memitem:a650b888f2d54cadfbe3347f3c9c40059"><td class="memItemLeft" align="right" valign="top">std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#a650b888f2d54cadfbe3347f3c9c40059">getDownloadFolder</a> ()</td></tr>
7e54d64b sago007 2018-06-24 15:21 86
<tr class="separator:a650b888f2d54cadfbe3347f3c9c40059"><td class="memSeparator" colspan="2">&#160;</td></tr>
7e54d64b sago007 2018-06-24 15:21 87
<tr class="memitem:a853ba2c62cd283e5b8836e9aa98610f3"><td class="memItemLeft" align="right" valign="top">std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#a853ba2c62cd283e5b8836e9aa98610f3">getDownloadFolder1</a> ()</td></tr>
7e54d64b sago007 2018-06-24 15:21 88
<tr class="separator:a853ba2c62cd283e5b8836e9aa98610f3"><td class="memSeparator" colspan="2">&#160;</td></tr>
7e54d64b sago007 2018-06-24 15:21 89
<tr class="memitem:a45b407f0581bf3ac349682eb2481c630"><td class="memItemLeft" align="right" valign="top">std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#a45b407f0581bf3ac349682eb2481c630">getPicturesFolder</a> ()</td></tr>
7e54d64b sago007 2018-06-24 15:21 90
<tr class="separator:a45b407f0581bf3ac349682eb2481c630"><td class="memSeparator" colspan="2">&#160;</td></tr>
7e54d64b sago007 2018-06-24 15:21 91
<tr class="memitem:a4c436b1cbbdc85b012877bc80e769dbc"><td class="memItemLeft" align="right" valign="top">std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#a4c436b1cbbdc85b012877bc80e769dbc">getPublicFolder</a> ()</td></tr>
7e54d64b sago007 2018-06-24 15:21 92
<tr class="separator:a4c436b1cbbdc85b012877bc80e769dbc"><td class="memSeparator" colspan="2">&#160;</td></tr>
7e54d64b sago007 2018-06-24 15:21 93
<tr class="memitem:aef0ecc52b536a96e2f3096b43acbfcbe"><td class="memItemLeft" align="right" valign="top">std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#aef0ecc52b536a96e2f3096b43acbfcbe">getMusicFolder</a> ()</td></tr>
7e54d64b sago007 2018-06-24 15:21 94
<tr class="separator:aef0ecc52b536a96e2f3096b43acbfcbe"><td class="memSeparator" colspan="2">&#160;</td></tr>
7e54d64b sago007 2018-06-24 15:21 95
<tr class="memitem:a8eda16d34cba4c0f82a6e80077660780"><td class="memItemLeft" align="right" valign="top">std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#a8eda16d34cba4c0f82a6e80077660780">getVideoFolder</a> ()</td></tr>
7e54d64b sago007 2018-06-24 15:21 96
<tr class="separator:a8eda16d34cba4c0f82a6e80077660780"><td class="memSeparator" colspan="2">&#160;</td></tr>
7e54d64b sago007 2018-06-24 15:21 97
<tr class="memitem:ab568df2aa5ea8492975bbefb206a6145"><td class="memItemLeft" align="right" valign="top">std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#ab568df2aa5ea8492975bbefb206a6145">getSaveGamesFolder1</a> ()</td></tr>
7e54d64b sago007 2018-06-24 15:21 98
<tr class="separator:ab568df2aa5ea8492975bbefb206a6145"><td class="memSeparator" colspan="2">&#160;</td></tr>
7e54d64b sago007 2018-06-24 15:21 99
<tr class="memitem:afc7986187926c19b217427a73bdae16e"><td class="memItemLeft" align="right" valign="top">std::string&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#afc7986187926c19b217427a73bdae16e">getSaveGamesFolder2</a> ()</td></tr>
7e54d64b sago007 2018-06-24 15:21 100
<tr class="separator:afc7986187926c19b217427a73bdae16e"><td class="memSeparator" colspan="2">&#160;</td></tr>
7e54d64b sago007 2018-06-24 15:21 101
</table>
7e54d64b sago007 2018-06-24 15:21 102
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
7e54d64b sago007 2018-06-24 15:21 103
<div class="textblock"><p>The namespace I use for common function. Nothing special about it. </p>
7e54d64b sago007 2018-06-24 15:21 104
</div><h2 class="groupheader">Function Documentation</h2>
7e54d64b sago007 2018-06-24 15:21 105
<a id="a760a4d546d0bccc82dc939ed6e10304d"></a>
7e54d64b sago007 2018-06-24 15:21 106
<h2 class="memtitle"><span class="permalink"><a href="#a760a4d546d0bccc82dc939ed6e10304d">&#9670;&nbsp;</a></span>appendAdditionalConfigDirectories()</h2>
7e54d64b sago007 2018-06-24 15:21 107
7e54d64b sago007 2018-06-24 15:21 108
<div class="memitem">
7e54d64b sago007 2018-06-24 15:21 109
<div class="memproto">
7e54d64b sago007 2018-06-24 15:21 110
      <table class="memname">
7e54d64b sago007 2018-06-24 15:21 111
        <tr>
7e54d64b sago007 2018-06-24 15:21 112
          <td class="memname">void sago::appendAdditionalConfigDirectories </td>
7e54d64b sago007 2018-06-24 15:21 113
          <td>(</td>
7e54d64b sago007 2018-06-24 15:21 114
          <td class="paramtype">std::vector&lt; std::string &gt; &amp;&#160;</td>
7e54d64b sago007 2018-06-24 15:21 115
          <td class="paramname"><em>homes</em></td><td>)</td>
7e54d64b sago007 2018-06-24 15:21 116
          <td></td>
7e54d64b sago007 2018-06-24 15:21 117
        </tr>
7e54d64b sago007 2018-06-24 15:21 118
      </table>
7e54d64b sago007 2018-06-24 15:21 119
</div><div class="memdoc">
7e54d64b sago007 2018-06-24 15:21 120
<p>This will append extra folders that your program should be looking for config files in. This does not normally include the path returned by GetConfigHome(). If you want all the folders you should do something like: </p><div class="fragment"><div class="line">std::vector&lt;std::string&gt; folders;</div><div class="line">folders.push_back(<a class="code" href="namespacesago.html#aa6c6da4e6fe460076ac069e176622f59">sago::getConfigHome</a>());</div><div class="line"><a class="code" href="namespacesago.html#a760a4d546d0bccc82dc939ed6e10304d">sago::appendAdditionalConfigDirectories</a>(folders);</div><div class="line"><span class="keywordflow">for</span> (std::string s&amp; : folders) {</div><div class="line">    s+=<span class="stringliteral">&quot;/My Program Name/&quot;</span>;</div><div class="line">}</div></div><!-- fragment --><p> You must apply "/My Program Name/" to all the strings. The string at the lowest index has the highest priority. </p><dl class="params"><dt>Parameters</dt><dd>
7e54d64b sago007 2018-06-24 15:21 121
  <table class="params">
7e54d64b sago007 2018-06-24 15:21 122
    <tr><td class="paramname">homes</td><td>A vector that extra folders will be appended to. </td></tr>
7e54d64b sago007 2018-06-24 15:21 123
  </table>
7e54d64b sago007 2018-06-24 15:21 124
  </dd>
7e54d64b sago007 2018-06-24 15:21 125
</dl>
7e54d64b sago007 2018-06-24 15:21 126
7e54d64b sago007 2018-06-24 15:21 127
</div>
7e54d64b sago007 2018-06-24 15:21 128
</div>
7e54d64b sago007 2018-06-24 15:21 129
<a id="a2d3b0d91188997c4949f5f39a24dd8ab"></a>
7e54d64b sago007 2018-06-24 15:21 130
<h2 class="memtitle"><span class="permalink"><a href="#a2d3b0d91188997c4949f5f39a24dd8ab">&#9670;&nbsp;</a></span>appendAdditionalDataDirectories()</h2>
7e54d64b sago007 2018-06-24 15:21 131
7e54d64b sago007 2018-06-24 15:21 132
<div class="memitem">
7e54d64b sago007 2018-06-24 15:21 133
<div class="memproto">
7e54d64b sago007 2018-06-24 15:21 134
      <table class="memname">
7e54d64b sago007 2018-06-24 15:21 135
        <tr>
7e54d64b sago007 2018-06-24 15:21 136
          <td class="memname">void sago::appendAdditionalDataDirectories </td>
7e54d64b sago007 2018-06-24 15:21 137
          <td>(</td>
7e54d64b sago007 2018-06-24 15:21 138
          <td class="paramtype">std::vector&lt; std::string &gt; &amp;&#160;</td>
7e54d64b sago007 2018-06-24 15:21 139
          <td class="paramname"><em>homes</em></td><td>)</td>
7e54d64b sago007 2018-06-24 15:21 140
          <td></td>
7e54d64b sago007 2018-06-24 15:21 141
        </tr>
7e54d64b sago007 2018-06-24 15:21 142
      </table>
7e54d64b sago007 2018-06-24 15:21 143
</div><div class="memdoc">
7e54d64b sago007 2018-06-24 15:21 144
<p>This will append extra folders that your program should be looking for data files in. This does not normally include the path returned by GetDataHome(). If you want all the folders you should do something like: </p><div class="fragment"><div class="line">vector&lt;string&gt; folders;</div><div class="line">folders.push_back(<a class="code" href="namespacesago.html#a85c382a039426b76aa408961ac2149ee">getDataHome</a>());</div><div class="line"><a class="code" href="namespacesago.html#a2d3b0d91188997c4949f5f39a24dd8ab">appendAdditionalDataDirectories</a>(folders);</div><div class="line"><span class="keywordflow">for</span> (<span class="keywordtype">string</span> s&amp; : folders) {</div><div class="line">    s+=<span class="stringliteral">&quot;/My Program Name/&quot;</span>;</div><div class="line">}</div></div><!-- fragment --><p> You must apply "/My Program Name/" to all the strings. The string at the lowest index has the highest priority. </p><dl class="params"><dt>Parameters</dt><dd>
7e54d64b sago007 2018-06-24 15:21 145
  <table class="params">
7e54d64b sago007 2018-06-24 15:21 146
    <tr><td class="paramname">homes</td><td>A vector that extra folders will be appended to. </td></tr>
7e54d64b sago007 2018-06-24 15:21 147
  </table>
7e54d64b sago007 2018-06-24 15:21 148
  </dd>
7e54d64b sago007 2018-06-24 15:21 149
</dl>
7e54d64b sago007 2018-06-24 15:21 150
7e54d64b sago007 2018-06-24 15:21 151
</div>
7e54d64b sago007 2018-06-24 15:21 152
</div>
7e54d64b sago007 2018-06-24 15:21 153
<a id="a426458c0e30383f23ecab17bdf55a407"></a>
7e54d64b sago007 2018-06-24 15:21 154
<h2 class="memtitle"><span class="permalink"><a href="#a426458c0e30383f23ecab17bdf55a407">&#9670;&nbsp;</a></span>getCacheDir()</h2>
7e54d64b sago007 2018-06-24 15:21 155
7e54d64b sago007 2018-06-24 15:21 156
<div class="memitem">
7e54d64b sago007 2018-06-24 15:21 157
<div class="memproto">
7e54d64b sago007 2018-06-24 15:21 158
      <table class="memname">
7e54d64b sago007 2018-06-24 15:21 159
        <tr>
7e54d64b sago007 2018-06-24 15:21 160
          <td class="memname">std::string sago::getCacheDir </td>
7e54d64b sago007 2018-06-24 15:21 161
          <td>(</td>
7e54d64b sago007 2018-06-24 15:21 162
          <td class="paramname"></td><td>)</td>
7e54d64b sago007 2018-06-24 15:21 163
          <td></td>
7e54d64b sago007 2018-06-24 15:21 164
        </tr>
7e54d64b sago007 2018-06-24 15:21 165
      </table>
7e54d64b sago007 2018-06-24 15:21 166
</div><div class="memdoc">
7e54d64b sago007 2018-06-24 15:21 167
<p>Retrives the base folder for storing cache files. You must add the program name yourself like this: </p><div class="fragment"><div class="line"><span class="keywordtype">string</span> data_home = <a class="code" href="namespacesago.html#a426458c0e30383f23ecab17bdf55a407">getCacheDir</a>()+<span class="stringliteral">&quot;/My Program Name/&quot;</span>;</div></div><!-- fragment --><p> On Windows this defaults to APPDATALOCAL% On Linux this defaults to ~/.cache but can be configured </p><dl class="section return"><dt>Returns</dt><dd>The base folder for storing data that do not need to be backed up. </dd></dl>
7e54d64b sago007 2018-06-24 15:21 168
7e54d64b sago007 2018-06-24 15:21 169
</div>
7e54d64b sago007 2018-06-24 15:21 170
</div>
7e54d64b sago007 2018-06-24 15:21 171
<a id="aa6c6da4e6fe460076ac069e176622f59"></a>
7e54d64b sago007 2018-06-24 15:21 172
<h2 class="memtitle"><span class="permalink"><a href="#aa6c6da4e6fe460076ac069e176622f59">&#9670;&nbsp;</a></span>getConfigHome()</h2>
7e54d64b sago007 2018-06-24 15:21 173
7e54d64b sago007 2018-06-24 15:21 174
<div class="memitem">
7e54d64b sago007 2018-06-24 15:21 175
<div class="memproto">
7e54d64b sago007 2018-06-24 15:21 176
      <table class="memname">
7e54d64b sago007 2018-06-24 15:21 177
        <tr>
7e54d64b sago007 2018-06-24 15:21 178
          <td class="memname">std::string sago::getConfigHome </td>
7e54d64b sago007 2018-06-24 15:21 179
          <td>(</td>
7e54d64b sago007 2018-06-24 15:21 180
          <td class="paramname"></td><td>)</td>
7e54d64b sago007 2018-06-24 15:21 181
          <td></td>
7e54d64b sago007 2018-06-24 15:21 182
        </tr>
7e54d64b sago007 2018-06-24 15:21 183
      </table>
7e54d64b sago007 2018-06-24 15:21 184
</div><div class="memdoc">
7e54d64b sago007 2018-06-24 15:21 185
<p>Retrives the base folder for storing config files. You must add the program name yourself like this: </p><div class="fragment"><div class="line"><span class="keywordtype">string</span> data_home = <a class="code" href="namespacesago.html#aa6c6da4e6fe460076ac069e176622f59">getConfigHome</a>()+<span class="stringliteral">&quot;/My Program Name/&quot;</span>;</div></div><!-- fragment --><p> On Windows this defaults to APPDATA% (Roaming profile) On Linux this defaults to ~/.config but can be configured </p><dl class="section return"><dt>Returns</dt><dd>The base folder for storing config data. </dd></dl>
7e54d64b sago007 2018-06-24 15:21 186
7e54d64b sago007 2018-06-24 15:21 187
</div>
7e54d64b sago007 2018-06-24 15:21 188
</div>
7e54d64b sago007 2018-06-24 15:21 189
<a id="a85c382a039426b76aa408961ac2149ee"></a>
7e54d64b sago007 2018-06-24 15:21 190
<h2 class="memtitle"><span class="permalink"><a href="#a85c382a039426b76aa408961ac2149ee">&#9670;&nbsp;</a></span>getDataHome()</h2>
7e54d64b sago007 2018-06-24 15:21 191
7e54d64b sago007 2018-06-24 15:21 192
<div class="memitem">
7e54d64b sago007 2018-06-24 15:21 193
<div class="memproto">
7e54d64b sago007 2018-06-24 15:21 194
      <table class="memname">
7e54d64b sago007 2018-06-24 15:21 195
        <tr>
7e54d64b sago007 2018-06-24 15:21 196
          <td class="memname">std::string sago::getDataHome </td>
7e54d64b sago007 2018-06-24 15:21 197
          <td>(</td>
7e54d64b sago007 2018-06-24 15:21 198
          <td class="paramname"></td><td>)</td>
7e54d64b sago007 2018-06-24 15:21 199
          <td></td>
7e54d64b sago007 2018-06-24 15:21 200
        </tr>
7e54d64b sago007 2018-06-24 15:21 201
      </table>
7e54d64b sago007 2018-06-24 15:21 202
</div><div class="memdoc">
7e54d64b sago007 2018-06-24 15:21 203
<p>Retrives the base folder for storing data files. You must add the program name yourself like this: </p><div class="fragment"><div class="line"><span class="keywordtype">string</span> data_home = <a class="code" href="namespacesago.html#a85c382a039426b76aa408961ac2149ee">getDataHome</a>()+<span class="stringliteral">&quot;/My Program Name/&quot;</span>;</div></div><!-- fragment --><p> On Windows this defaults to APPDATA% (Roaming profile) On Linux this defaults to ~/.local/share but can be configured </p><dl class="section return"><dt>Returns</dt><dd>The base folder for storing program data. </dd></dl>
7e54d64b sago007 2018-06-24 15:21 204
7e54d64b sago007 2018-06-24 15:21 205
</div>
7e54d64b sago007 2018-06-24 15:21 206
</div>
7e54d64b sago007 2018-06-24 15:21 207
<a id="ac9fc8e0a8f97b7066548223d43720ce8"></a>
7e54d64b sago007 2018-06-24 15:21 208
<h2 class="memtitle"><span class="permalink"><a href="#ac9fc8e0a8f97b7066548223d43720ce8">&#9670;&nbsp;</a></span>getDesktopFolder()</h2>
7e54d64b sago007 2018-06-24 15:21 209
7e54d64b sago007 2018-06-24 15:21 210
<div class="memitem">
7e54d64b sago007 2018-06-24 15:21 211
<div class="memproto">
7e54d64b sago007 2018-06-24 15:21 212
      <table class="memname">
7e54d64b sago007 2018-06-24 15:21 213
        <tr>
7e54d64b sago007 2018-06-24 15:21 214
          <td class="memname">std::string sago::getDesktopFolder </td>
7e54d64b sago007 2018-06-24 15:21 215
          <td>(</td>
7e54d64b sago007 2018-06-24 15:21 216
          <td class="paramname"></td><td>)</td>
7e54d64b sago007 2018-06-24 15:21 217
          <td></td>
7e54d64b sago007 2018-06-24 15:21 218
        </tr>
7e54d64b sago007 2018-06-24 15:21 219
      </table>
7e54d64b sago007 2018-06-24 15:21 220
</div><div class="memdoc">
7e54d64b sago007 2018-06-24 15:21 221
<p>The folder that represents the desktop. Normally you should try not to use this folder. </p><dl class="section return"><dt>Returns</dt><dd>Absolute path to the user's desktop </dd></dl>
7e54d64b sago007 2018-06-24 15:21 222
7e54d64b sago007 2018-06-24 15:21 223
</div>
7e54d64b sago007 2018-06-24 15:21 224
</div>
7e54d64b sago007 2018-06-24 15:21 225
<a id="aa44dc2057a9acdb38a10e41a60b7bb82"></a>
7e54d64b sago007 2018-06-24 15:21 226
<h2 class="memtitle"><span class="permalink"><a href="#aa44dc2057a9acdb38a10e41a60b7bb82">&#9670;&nbsp;</a></span>getDocumentsFolder()</h2>
7e54d64b sago007 2018-06-24 15:21 227
7e54d64b sago007 2018-06-24 15:21 228
<div class="memitem">
7e54d64b sago007 2018-06-24 15:21 229
<div class="memproto">
7e54d64b sago007 2018-06-24 15:21 230
      <table class="memname">
7e54d64b sago007 2018-06-24 15:21 231
        <tr>
7e54d64b sago007 2018-06-24 15:21 232
          <td class="memname">std::string sago::getDocumentsFolder </td>
7e54d64b sago007 2018-06-24 15:21 233
          <td>(</td>
7e54d64b sago007 2018-06-24 15:21 234
          <td class="paramname"></td><td>)</td>
7e54d64b sago007 2018-06-24 15:21 235
          <td></td>
7e54d64b sago007 2018-06-24 15:21 236
        </tr>
7e54d64b sago007 2018-06-24 15:21 237
      </table>
7e54d64b sago007 2018-06-24 15:21 238
</div><div class="memdoc">
7e54d64b sago007 2018-06-24 15:21 239
<p>The folder to store user documents to </p><dl class="section return"><dt>Returns</dt><dd>Absolute path to the "Documents" folder </dd></dl>
7e54d64b sago007 2018-06-24 15:21 240
7e54d64b sago007 2018-06-24 15:21 241
</div>
7e54d64b sago007 2018-06-24 15:21 242
</div>
7e54d64b sago007 2018-06-24 15:21 243
<a id="a650b888f2d54cadfbe3347f3c9c40059"></a>
7e54d64b sago007 2018-06-24 15:21 244
<h2 class="memtitle"><span class="permalink"><a href="#a650b888f2d54cadfbe3347f3c9c40059">&#9670;&nbsp;</a></span>getDownloadFolder()</h2>
7e54d64b sago007 2018-06-24 15:21 245
7e54d64b sago007 2018-06-24 15:21 246
<div class="memitem">
7e54d64b sago007 2018-06-24 15:21 247
<div class="memproto">
7e54d64b sago007 2018-06-24 15:21 248
      <table class="memname">
7e54d64b sago007 2018-06-24 15:21 249
        <tr>
7e54d64b sago007 2018-06-24 15:21 250
          <td class="memname">std::string sago::getDownloadFolder </td>
7e54d64b sago007 2018-06-24 15:21 251
          <td>(</td>
7e54d64b sago007 2018-06-24 15:21 252
          <td class="paramname"></td><td>)</td>
7e54d64b sago007 2018-06-24 15:21 253
          <td></td>
7e54d64b sago007 2018-06-24 15:21 254
        </tr>
7e54d64b sago007 2018-06-24 15:21 255
      </table>
7e54d64b sago007 2018-06-24 15:21 256
</div><div class="memdoc">
7e54d64b sago007 2018-06-24 15:21 257
<p>The folder where files are downloaded. </p><dl class="section return"><dt>Returns</dt><dd>Absolute path to the folder where files are downloaded to. </dd></dl>
7e54d64b sago007 2018-06-24 15:21 258
7e54d64b sago007 2018-06-24 15:21 259
</div>
7e54d64b sago007 2018-06-24 15:21 260
</div>
7e54d64b sago007 2018-06-24 15:21 261
<a id="a853ba2c62cd283e5b8836e9aa98610f3"></a>
7e54d64b sago007 2018-06-24 15:21 262
<h2 class="memtitle"><span class="permalink"><a href="#a853ba2c62cd283e5b8836e9aa98610f3">&#9670;&nbsp;</a></span>getDownloadFolder1()</h2>
7e54d64b sago007 2018-06-24 15:21 263
7e54d64b sago007 2018-06-24 15:21 264
<div class="memitem">
7e54d64b sago007 2018-06-24 15:21 265
<div class="memproto">
7e54d64b sago007 2018-06-24 15:21 266
      <table class="memname">
7e54d64b sago007 2018-06-24 15:21 267
        <tr>
7e54d64b sago007 2018-06-24 15:21 268
          <td class="memname">std::string sago::getDownloadFolder1 </td>
7e54d64b sago007 2018-06-24 15:21 269
          <td>(</td>
7e54d64b sago007 2018-06-24 15:21 270
          <td class="paramname"></td><td>)</td>
7e54d64b sago007 2018-06-24 15:21 271
          <td></td>
7e54d64b sago007 2018-06-24 15:21 272
        </tr>
7e54d64b sago007 2018-06-24 15:21 273
      </table>
7e54d64b sago007 2018-06-24 15:21 274
</div><div class="memdoc">
7e54d64b sago007 2018-06-24 15:21 275
<p>The folder where files are downloaded. </p><dl class="section note"><dt>Note</dt><dd>This is provided for backward compatibility. Use getDownloadFolder instead. </dd></dl>
7e54d64b sago007 2018-06-24 15:21 276
<dl class="section return"><dt>Returns</dt><dd>Absolute path to the folder where files are downloaded to. </dd></dl>
7e54d64b sago007 2018-06-24 15:21 277
7e54d64b sago007 2018-06-24 15:21 278
</div>
7e54d64b sago007 2018-06-24 15:21 279
</div>
7e54d64b sago007 2018-06-24 15:21 280
<a id="aef0ecc52b536a96e2f3096b43acbfcbe"></a>
7e54d64b sago007 2018-06-24 15:21 281
<h2 class="memtitle"><span class="permalink"><a href="#aef0ecc52b536a96e2f3096b43acbfcbe">&#9670;&nbsp;</a></span>getMusicFolder()</h2>
7e54d64b sago007 2018-06-24 15:21 282
7e54d64b sago007 2018-06-24 15:21 283
<div class="memitem">
7e54d64b sago007 2018-06-24 15:21 284
<div class="memproto">
7e54d64b sago007 2018-06-24 15:21 285
      <table class="memname">
7e54d64b sago007 2018-06-24 15:21 286
        <tr>
7e54d64b sago007 2018-06-24 15:21 287
          <td class="memname">std::string sago::getMusicFolder </td>
7e54d64b sago007 2018-06-24 15:21 288
          <td>(</td>
7e54d64b sago007 2018-06-24 15:21 289
          <td class="paramname"></td><td>)</td>
7e54d64b sago007 2018-06-24 15:21 290
          <td></td>
7e54d64b sago007 2018-06-24 15:21 291
        </tr>
7e54d64b sago007 2018-06-24 15:21 292
      </table>
7e54d64b sago007 2018-06-24 15:21 293
</div><div class="memdoc">
7e54d64b sago007 2018-06-24 15:21 294
<p>The folder where music is stored </p><dl class="section return"><dt>Returns</dt><dd>Absolute path to the music folder </dd></dl>
7e54d64b sago007 2018-06-24 15:21 295
7e54d64b sago007 2018-06-24 15:21 296
</div>
7e54d64b sago007 2018-06-24 15:21 297
</div>
7e54d64b sago007 2018-06-24 15:21 298
<a id="a45b407f0581bf3ac349682eb2481c630"></a>
7e54d64b sago007 2018-06-24 15:21 299
<h2 class="memtitle"><span class="permalink"><a href="#a45b407f0581bf3ac349682eb2481c630">&#9670;&nbsp;</a></span>getPicturesFolder()</h2>
7e54d64b sago007 2018-06-24 15:21 300
7e54d64b sago007 2018-06-24 15:21 301
<div class="memitem">
7e54d64b sago007 2018-06-24 15:21 302
<div class="memproto">
7e54d64b sago007 2018-06-24 15:21 303
      <table class="memname">
7e54d64b sago007 2018-06-24 15:21 304
        <tr>
7e54d64b sago007 2018-06-24 15:21 305
          <td class="memname">std::string sago::getPicturesFolder </td>
7e54d64b sago007 2018-06-24 15:21 306
          <td>(</td>
7e54d64b sago007 2018-06-24 15:21 307
          <td class="paramname"></td><td>)</td>
7e54d64b sago007 2018-06-24 15:21 308
          <td></td>
7e54d64b sago007 2018-06-24 15:21 309
        </tr>
7e54d64b sago007 2018-06-24 15:21 310
      </table>
7e54d64b sago007 2018-06-24 15:21 311
</div><div class="memdoc">
7e54d64b sago007 2018-06-24 15:21 312
<p>The folder for storing the user's pictures. </p><dl class="section return"><dt>Returns</dt><dd>Absolute path to the "Picture" folder </dd></dl>
7e54d64b sago007 2018-06-24 15:21 313
7e54d64b sago007 2018-06-24 15:21 314
</div>
7e54d64b sago007 2018-06-24 15:21 315
</div>
7e54d64b sago007 2018-06-24 15:21 316
<a id="a4c436b1cbbdc85b012877bc80e769dbc"></a>
7e54d64b sago007 2018-06-24 15:21 317
<h2 class="memtitle"><span class="permalink"><a href="#a4c436b1cbbdc85b012877bc80e769dbc">&#9670;&nbsp;</a></span>getPublicFolder()</h2>
7e54d64b sago007 2018-06-24 15:21 318
7e54d64b sago007 2018-06-24 15:21 319
<div class="memitem">
7e54d64b sago007 2018-06-24 15:21 320
<div class="memproto">
7e54d64b sago007 2018-06-24 15:21 321
      <table class="memname">
7e54d64b sago007 2018-06-24 15:21 322
        <tr>
7e54d64b sago007 2018-06-24 15:21 323
          <td class="memname">std::string sago::getPublicFolder </td>
7e54d64b sago007 2018-06-24 15:21 324
          <td>(</td>
7e54d64b sago007 2018-06-24 15:21 325
          <td class="paramname"></td><td>)</td>
7e54d64b sago007 2018-06-24 15:21 326
          <td></td>
7e54d64b sago007 2018-06-24 15:21 327
        </tr>
7e54d64b sago007 2018-06-24 15:21 328
      </table>
7e54d64b sago007 2018-06-24 15:21 329
</div><div class="memdoc">
7e54d64b sago007 2018-06-24 15:21 330
<p>This returns the folder that can be used for sharing files with other users on the same system. </p><dl class="section return"><dt>Returns</dt><dd>Absolute path to the "Public" folder </dd></dl>
7e54d64b sago007 2018-06-24 15:21 331
7e54d64b sago007 2018-06-24 15:21 332
</div>
7e54d64b sago007 2018-06-24 15:21 333
</div>
7e54d64b sago007 2018-06-24 15:21 334
<a id="ab568df2aa5ea8492975bbefb206a6145"></a>
7e54d64b sago007 2018-06-24 15:21 335
<h2 class="memtitle"><span class="permalink"><a href="#ab568df2aa5ea8492975bbefb206a6145">&#9670;&nbsp;</a></span>getSaveGamesFolder1()</h2>
7e54d64b sago007 2018-06-24 15:21 336
7e54d64b sago007 2018-06-24 15:21 337
<div class="memitem">
7e54d64b sago007 2018-06-24 15:21 338
<div class="memproto">
7e54d64b sago007 2018-06-24 15:21 339
      <table class="memname">
7e54d64b sago007 2018-06-24 15:21 340
        <tr>
7e54d64b sago007 2018-06-24 15:21 341
          <td class="memname">std::string sago::getSaveGamesFolder1 </td>
7e54d64b sago007 2018-06-24 15:21 342
          <td>(</td>
7e54d64b sago007 2018-06-24 15:21 343
          <td class="paramname"></td><td>)</td>
7e54d64b sago007 2018-06-24 15:21 344
          <td></td>
7e54d64b sago007 2018-06-24 15:21 345
        </tr>
7e54d64b sago007 2018-06-24 15:21 346
      </table>
7e54d64b sago007 2018-06-24 15:21 347
</div><div class="memdoc">
7e54d64b sago007 2018-06-24 15:21 348
<p>A base folder for storing saved games. You must add the program name to it like this: </p><div class="fragment"><div class="line"><span class="keywordtype">string</span> saved_games_folder = <a class="code" href="namespacesago.html#ab568df2aa5ea8492975bbefb206a6145">sago::getSaveGamesFolder1</a>()+<span class="stringliteral">&quot;/My Program Name/&quot;</span>;</div></div><!-- fragment --> <dl class="section note"><dt>Note</dt><dd>Windows: This is an XP compatible version and returns the path to "My Games" in Documents. Vista and later has an official folder. </dd>
7e54d64b sago007 2018-06-24 15:21 349
<dd>
7e54d64b sago007 2018-06-24 15:21 350
Linux: XDF does not define a folder for saved games. This will just return the same as GetDataHome() </dd></dl>
7e54d64b sago007 2018-06-24 15:21 351
<dl class="section return"><dt>Returns</dt><dd>The folder base folder for storing save games. </dd></dl>
7e54d64b sago007 2018-06-24 15:21 352
7e54d64b sago007 2018-06-24 15:21 353
</div>
7e54d64b sago007 2018-06-24 15:21 354
</div>
7e54d64b sago007 2018-06-24 15:21 355
<a id="afc7986187926c19b217427a73bdae16e"></a>
7e54d64b sago007 2018-06-24 15:21 356
<h2 class="memtitle"><span class="permalink"><a href="#afc7986187926c19b217427a73bdae16e">&#9670;&nbsp;</a></span>getSaveGamesFolder2()</h2>
7e54d64b sago007 2018-06-24 15:21 357
7e54d64b sago007 2018-06-24 15:21 358
<div class="memitem">
7e54d64b sago007 2018-06-24 15:21 359
<div class="memproto">
7e54d64b sago007 2018-06-24 15:21 360
      <table class="memname">
7e54d64b sago007 2018-06-24 15:21 361
        <tr>
7e54d64b sago007 2018-06-24 15:21 362
          <td class="memname">std::string sago::getSaveGamesFolder2 </td>
7e54d64b sago007 2018-06-24 15:21 363
          <td>(</td>
7e54d64b sago007 2018-06-24 15:21 364
          <td class="paramname"></td><td>)</td>
7e54d64b sago007 2018-06-24 15:21 365
          <td></td>
7e54d64b sago007 2018-06-24 15:21 366
        </tr>
7e54d64b sago007 2018-06-24 15:21 367
      </table>
7e54d64b sago007 2018-06-24 15:21 368
</div><div class="memdoc">
7e54d64b sago007 2018-06-24 15:21 369
<p>A base folder for storing saved games. You must add the program name to it like this: </p><div class="fragment"><div class="line"><span class="keywordtype">string</span> saved_games_folder = <a class="code" href="namespacesago.html#afc7986187926c19b217427a73bdae16e">sago::getSaveGamesFolder2</a>()+<span class="stringliteral">&quot;/My Program Name/&quot;</span>;</div></div><!-- fragment --> <dl class="section note"><dt>Note</dt><dd>PlatformFolders provide different folders to for saved games as not all operating systems has support for Saved Games yet. It is recommended to pick the highest number (currently getSaveGamesFolder2) at the time your product enters production and stick with it </dd>
7e54d64b sago007 2018-06-24 15:21 370
<dd>
7e54d64b sago007 2018-06-24 15:21 371
Windows: This returns the "Saved Games" folder. This folder exist in Vista and later </dd>
7e54d64b sago007 2018-06-24 15:21 372
<dd>
7e54d64b sago007 2018-06-24 15:21 373
Linux: XDF does not define a folder for saved games. This will just return the same as GetDataHome() </dd></dl>
7e54d64b sago007 2018-06-24 15:21 374
<dl class="section return"><dt>Returns</dt><dd>The folder base folder for storing save games. </dd></dl>
7e54d64b sago007 2018-06-24 15:21 375
7e54d64b sago007 2018-06-24 15:21 376
</div>
7e54d64b sago007 2018-06-24 15:21 377
</div>
7e54d64b sago007 2018-06-24 15:21 378
<a id="a8eda16d34cba4c0f82a6e80077660780"></a>
7e54d64b sago007 2018-06-24 15:21 379
<h2 class="memtitle"><span class="permalink"><a href="#a8eda16d34cba4c0f82a6e80077660780">&#9670;&nbsp;</a></span>getVideoFolder()</h2>
7e54d64b sago007 2018-06-24 15:21 380
7e54d64b sago007 2018-06-24 15:21 381
<div class="memitem">
7e54d64b sago007 2018-06-24 15:21 382
<div class="memproto">
7e54d64b sago007 2018-06-24 15:21 383
      <table class="memname">
7e54d64b sago007 2018-06-24 15:21 384
        <tr>
7e54d64b sago007 2018-06-24 15:21 385
          <td class="memname">std::string sago::getVideoFolder </td>
7e54d64b sago007 2018-06-24 15:21 386
          <td>(</td>
7e54d64b sago007 2018-06-24 15:21 387
          <td class="paramname"></td><td>)</td>
7e54d64b sago007 2018-06-24 15:21 388
          <td></td>
7e54d64b sago007 2018-06-24 15:21 389
        </tr>
7e54d64b sago007 2018-06-24 15:21 390
      </table>
7e54d64b sago007 2018-06-24 15:21 391
</div><div class="memdoc">
7e54d64b sago007 2018-06-24 15:21 392
<p>The folder where video is stored </p><dl class="section return"><dt>Returns</dt><dd>Absolute path to the video folder </dd></dl>
7e54d64b sago007 2018-06-24 15:21 393
7e54d64b sago007 2018-06-24 15:21 394
</div>
7e54d64b sago007 2018-06-24 15:21 395
</div>
7e54d64b sago007 2018-06-24 15:21 396
</div><!-- contents -->
7e54d64b sago007 2018-06-24 15:21 397
<!-- start footer part -->
7e54d64b sago007 2018-06-24 15:21 398
<hr class="footer"/><address class="footer"><small>
7e54d64b sago007 2018-06-24 15:21 399
Generated on Sun Jun 24 2018 16:42:25 for Platform folders by &#160;<a href="http://www.doxygen.org/index.html">
7e54d64b sago007 2018-06-24 15:21 400
<img class="footer" src="doxygen.png" alt="doxygen"/>
7e54d64b sago007 2018-06-24 15:21 401
</a> 1.8.13
7e54d64b sago007 2018-06-24 15:21 402
</small></address>
7e54d64b sago007 2018-06-24 15:21 403
</body>
7e54d64b sago007 2018-06-24 15:21 404
</html>
1970-01-01 00:00 405