Documentation improvements

2025-08-26 20:52:06 -07:00
parent faef620629
commit efd4ed2662
10 changed files with 158 additions and 138 deletions
--- a/README.md
+++ b/README.md
@@ -54,6 +54,12 @@ For more information on connecting the Pico to a VGA display, check out the **Co

 * [Connections](https://codaris.github.io/picovga-cmake/connections)

+## Tools
+
+The `tools` folder contains the support programs used to prepare images, palettes, and sounds for use with the **PicoVGA** library.
+
+* [Tools and Palettes](https://codaris.github.io/picovga-cmake/tools)
+
 ## License terms

 The PicoVGA library source code and the PicoVGA library sample programs are freely available for further use and modifications. This does not apply to certain graphics and sounds (such as the sounds in Pac-Man) and scene definitions in Sokoban, as these are subject to third party copyrights and may be subject to different distribution terms.
--- a/docs/index.html
+++ b/docs/index.html
@@ -137,9 +137,15 @@ Examples and Tutorials</h1>
 <li><a class="el" href="connections.html">Connections</a></li>
 </ul>
 <h1><a class="anchor" id="autotoc_md11"></a>
+Tools</h1>
+<p>The <code>tools</code> folder contains the support programs used to prepare images, palettes, and sounds for use with the <b>PicoVGA</b> library.</p>
+<ul>
+<li><a class="el" href="tools.html">Tools and Palettes</a></li>
+</ul>
+<h1><a class="anchor" id="autotoc_md12"></a>
 License terms</h1>
 <p>The PicoVGA library source code and the PicoVGA library sample programs are freely available for further use and modifications. This does not apply to certain graphics and sounds (such as the sounds in Pac-Man) and scene definitions in Sokoban, as these are subject to third party copyrights and may be subject to different distribution terms.</p>
-<h1><a class="anchor" id="autotoc_md12"></a>
+<h1><a class="anchor" id="autotoc_md13"></a>
 Getting Help</h1>
 <p>You can get help with this library using the <a href="https://github.com/Panda381/PicoVGA/issues">Issues tab</a> in the <a href="https://github.com/Panda381/PicoVGA">original PicoVGA project</a>. For issues related to this fork of the library, please use the <a href="https://github.com/codaris/picovga-cmake/issues">Issues tab</a> for PicoVGA-cmake.</p>
 <p>How to inform about found defects:</p>
--- a/docs/navtreedata.js
+++ b/docs/navtreedata.js
@@ -30,8 +30,9 @@ var NAVTREE =
      [ "About PicoVGA", "index.html#autotoc_md8", null ],
      [ "Features", "index.html#autotoc_md9", null ],
      [ "Examples and Tutorials", "index.html#autotoc_md10", null ],
-      [ "License terms", "index.html#autotoc_md11", null ],
-      [ "Getting Help", "index.html#autotoc_md12", null ]
+      [ "Tools", "index.html#autotoc_md11", null ],
+      [ "License terms", "index.html#autotoc_md12", null ],
+      [ "Getting Help", "index.html#autotoc_md13", null ]
    ] ],
    [ "Connections", "connections.html", [
      [ "How to Connect to VGA display", "connections.html#autotoc_md0", null ],
@@ -46,44 +47,44 @@ var NAVTREE =
    ] ],
    [ "Tools and Palettes", "tools.html", [
      [ "Image Conversion Tool", "tools.html#picovga_img", [
-        [ "Usage", "tools.html#autotoc_md13", null ],
-        [ "Supported Image Formats", "tools.html#autotoc_md14", null ],
-        [ "Palettes", "tools.html#autotoc_md15", null ],
-        [ "Output", "tools.html#autotoc_md16", null ]
+        [ "Usage", "tools.html#autotoc_md14", null ],
+        [ "Supported Image Formats", "tools.html#autotoc_md15", null ],
+        [ "Palettes", "tools.html#autotoc_md16", null ],
+        [ "Output", "tools.html#autotoc_md17", null ]
      ] ],
      [ "RLE Compression Tool", "tools.html#picovga_rle", [
-        [ "Usage", "tools.html#autotoc_md17", null ],
-        [ "Input Requirements", "tools.html#autotoc_md18", null ],
-        [ "Transparency", "tools.html#autotoc_md19", null ],
-        [ "Output", "tools.html#autotoc_md20", null ],
-        [ "Internal Encoding", "tools.html#autotoc_md21", null ],
-        [ "Compatibility Warning", "tools.html#autotoc_md22", null ]
+        [ "Usage", "tools.html#autotoc_md18", null ],
+        [ "Input Requirements", "tools.html#autotoc_md19", null ],
+        [ "Transparency", "tools.html#autotoc_md20", null ],
+        [ "Output", "tools.html#autotoc_md21", null ],
+        [ "Internal Encoding", "tools.html#autotoc_md22", null ],
+        [ "Compatibility Warning", "tools.html#autotoc_md23", null ]
      ] ],
      [ "Sound Import Tool", "tools.html#picovga_snd", [
-        [ "Usage", "tools.html#autotoc_md23", null ],
-        [ "Input Requirements", "tools.html#autotoc_md24", [
-          [ "Recommended Editors", "tools.html#autotoc_md25", null ]
+        [ "Usage", "tools.html#autotoc_md24", null ],
+        [ "Input Requirements", "tools.html#autotoc_md25", [
+          [ "Recommended Editors", "tools.html#autotoc_md26", null ]
        ] ],
-        [ "Output", "tools.html#autotoc_md26", null ]
+        [ "Output", "tools.html#autotoc_md27", null ]
      ] ],
      [ "8-bit Palette Generator", "tools.html#picvovga_pal332", [
-        [ "Output Files", "tools.html#autotoc_md27", null ],
-        [ "Usage in Image Editors", "tools.html#autotoc_md28", null ]
+        [ "Output Files", "tools.html#autotoc_md28", null ],
+        [ "Usage in Image Editors", "tools.html#autotoc_md29", null ]
      ] ],
      [ "Palettes", "tools.html#palettes", [
-        [ "Available Palettes", "tools.html#autotoc_md29", null ],
-        [ "Palette Details", "tools.html#autotoc_md30", null ]
+        [ "Available Palettes", "tools.html#autotoc_md30", null ],
+        [ "Palette Details", "tools.html#autotoc_md31", null ]
      ] ]
    ] ],
    [ "Usage Rules", "usagerules.html", [
-      [ "Core Utilization", "usagerules.html#autotoc_md31", null ],
-      [ "Memory Rules", "usagerules.html#autotoc_md32", null ],
-      [ "Rendering Performance", "usagerules.html#autotoc_md33", null ],
-      [ "DMA Considerations", "usagerules.html#autotoc_md34", null ],
-      [ "CPU Clock Frequency", "usagerules.html#autotoc_md35", null ],
-      [ "Memory Alignment", "usagerules.html#autotoc_md36", null ],
-      [ "PIO Usage", "usagerules.html#autotoc_md37", null ],
-      [ "Summary", "usagerules.html#autotoc_md38", null ]
+      [ "Core Utilization", "usagerules.html#autotoc_md32", null ],
+      [ "Memory Rules", "usagerules.html#autotoc_md33", null ],
+      [ "Rendering Performance", "usagerules.html#autotoc_md34", null ],
+      [ "DMA Considerations", "usagerules.html#autotoc_md35", null ],
+      [ "CPU Clock Frequency", "usagerules.html#autotoc_md36", null ],
+      [ "Memory Alignment", "usagerules.html#autotoc_md37", null ],
+      [ "PIO Usage", "usagerules.html#autotoc_md38", null ],
+      [ "Summary", "usagerules.html#autotoc_md39", null ]
    ] ],
    [ "API Modules", "modules.html", "modules" ],
    [ "Data Structures", "annotated.html", [
@@ -116,7 +117,7 @@ var NAVTREEINDEX =
 "group__CanvasGroup.html#ga8b38b2530c058e70233c8ae6c622cfef",
 "group__OverclockGroup.html",
 "group__TextGroup.html#gac91910c7276ceff7cb48fa6733a1e343",
-"structsLayer.html#a8cfe006acd74ac0a1266fea6640a01f1"
+"structsLayer.html#a7faa17573c513e11a8b2db896faa39c1"
 ];

 var SYNCONMSG = 'click to disable panel synchronisation';
--- a/docs/navtreeindex1.js
+++ b/docs/navtreeindex1.js
@@ -70,8 +70,8 @@ var NAVTREEINDEX1 =
 "group__ColorsGroup.html#ga533f24800a34df26cf9f95086f376998":[7,0,1,5,22],
 "group__ColorsGroup.html#ga533f24800a34df26cf9f95086f376998":[5,5,22],
 "group__ColorsGroup.html#ga54539d4fa33f5e7cab4b31d8564039a3":[7,0,1,5,51],
-"group__ColorsGroup.html#ga57bbe8f45c1848fed8fa017cd9b21341":[7,0,1,5,32],
 "group__ColorsGroup.html#ga57bbe8f45c1848fed8fa017cd9b21341":[5,5,32],
+"group__ColorsGroup.html#ga57bbe8f45c1848fed8fa017cd9b21341":[7,0,1,5,32],
 "group__ColorsGroup.html#ga5e24f31ef961348d92de14b888eb4d82":[7,0,1,5,18],
 "group__ColorsGroup.html#ga5e24f31ef961348d92de14b888eb4d82":[5,5,18],
 "group__ColorsGroup.html#ga64415a2323090b0b23aef6d0df8c9010":[7,0,1,5,60],
@@ -90,8 +90,8 @@ var NAVTREEINDEX1 =
 "group__ColorsGroup.html#ga7f0eea2b5b9b02bbb51458d0d7b5cc75":[5,5,13],
 "group__ColorsGroup.html#ga7f32e59f92b3ac13320d52398083b573":[7,0,1,5,10],
 "group__ColorsGroup.html#ga7f32e59f92b3ac13320d52398083b573":[5,5,10],
-"group__ColorsGroup.html#ga80912f84c604fc199e620ade216da0fb":[5,5,35],
 "group__ColorsGroup.html#ga80912f84c604fc199e620ade216da0fb":[7,0,1,5,69],
+"group__ColorsGroup.html#ga80912f84c604fc199e620ade216da0fb":[5,5,35],
 "group__ColorsGroup.html#ga82a5b42035ce5ade621c4273e96ac6b7":[5,5,12],
 "group__ColorsGroup.html#ga82a5b42035ce5ade621c4273e96ac6b7":[7,0,1,5,12],
 "group__ColorsGroup.html#ga87d30d2657caae38d671f052cb9cc0e7":[7,0,1,5,46],
@@ -100,8 +100,8 @@ var NAVTREEINDEX1 =
 "group__ColorsGroup.html#ga921fd1e906e91a2163563b10b3e837a6":[7,0,1,5,48],
 "group__ColorsGroup.html#ga9d9ef01f0c0939fcc763256a368ea628":[7,0,1,5,72],
 "group__ColorsGroup.html#ga9d9ef01f0c0939fcc763256a368ea628":[5,5,38],
-"group__ColorsGroup.html#ga9ddd5d8cc8ff2ed5c7f7cc606248aead":[5,5,20],
 "group__ColorsGroup.html#ga9ddd5d8cc8ff2ed5c7f7cc606248aead":[7,0,1,5,20],
+"group__ColorsGroup.html#ga9ddd5d8cc8ff2ed5c7f7cc606248aead":[5,5,20],
 "group__ColorsGroup.html#ga9e66d1aad9d70c0590f885f799affbf4":[7,0,1,5,63],
 "group__ColorsGroup.html#gaab2b3ae1a8ed318567870655a12a235c":[7,0,1,5,42],
 "group__ColorsGroup.html#gaac8ed5cdea094d200bdc7063d00727c4":[7,0,1,5,34],
@@ -112,13 +112,13 @@ var NAVTREEINDEX1 =
 "group__ColorsGroup.html#gaae2a7f017313fe4f72efac08495338dc":[5,5,42],
 "group__ColorsGroup.html#gab01da00edd299988b4b4f30893e84e51":[7,0,1,5,16],
 "group__ColorsGroup.html#gab01da00edd299988b4b4f30893e84e51":[5,5,16],
-"group__ColorsGroup.html#gab15efd2b29192c9e35ca30ef075f9976":[7,0,1,5,14],
 "group__ColorsGroup.html#gab15efd2b29192c9e35ca30ef075f9976":[5,5,14],
+"group__ColorsGroup.html#gab15efd2b29192c9e35ca30ef075f9976":[7,0,1,5,14],
 "group__ColorsGroup.html#gab43d256cd2afa78a9fc11d169155c967":[7,0,1,5,36],
 "group__ColorsGroup.html#gab6f7163f4a62b6fd431ae8c3c2e4476b":[7,0,1,5,8],
 "group__ColorsGroup.html#gab6f7163f4a62b6fd431ae8c3c2e4476b":[5,5,8],
-"group__ColorsGroup.html#gabceaf8fb5d6638b2c0f9f398380e8feb":[7,0,1,5,67],
 "group__ColorsGroup.html#gabceaf8fb5d6638b2c0f9f398380e8feb":[5,5,33],
+"group__ColorsGroup.html#gabceaf8fb5d6638b2c0f9f398380e8feb":[7,0,1,5,67],
 "group__ColorsGroup.html#gabe5310f52c8d95f6e5597285e035125c":[7,0,1,5,40],
 "group__ColorsGroup.html#gabe88931ea3723b480083bfd0b337551b":[7,0,1,5,43],
 "group__ColorsGroup.html#gac2ebc6dedc3a7b12a0abf60753334166":[7,0,1,5,37],
@@ -128,10 +128,10 @@ var NAVTREEINDEX1 =
 "group__ColorsGroup.html#gac4f2ca33b957169e3d57bf57b4b886a7":[7,0,1,5,33],
 "group__ColorsGroup.html#gacfbe6cde5f3c2cc96da67045c1899b82":[7,0,1,5,58],
 "group__ColorsGroup.html#gad4e2b3b76645d9df1e44ded867100c74":[7,0,1,5,61],
-"group__ColorsGroup.html#gad6d524039074d3563baf98d7e78096e9":[5,5,23],
 "group__ColorsGroup.html#gad6d524039074d3563baf98d7e78096e9":[7,0,1,5,23],
-"group__ColorsGroup.html#gadc8ef66ae4cfecf46b69032fb52faa8e":[7,0,1,5,19],
+"group__ColorsGroup.html#gad6d524039074d3563baf98d7e78096e9":[5,5,23],
 "group__ColorsGroup.html#gadc8ef66ae4cfecf46b69032fb52faa8e":[5,5,19],
+"group__ColorsGroup.html#gadc8ef66ae4cfecf46b69032fb52faa8e":[7,0,1,5,19],
 "group__ColorsGroup.html#gadd567066969c92e59501aa12afd58271":[7,0,1,5,25],
 "group__ColorsGroup.html#gadd567066969c92e59501aa12afd58271":[5,5,25],
 "group__ColorsGroup.html#gadd6ed012790320454ab9ce9801070fe6":[7,0,1,5,1],
@@ -143,11 +143,11 @@ var NAVTREEINDEX1 =
 "group__ColorsGroup.html#gae7628f0f480ae146911ca32c5aa835a6":[5,5,3],
 "group__ColorsGroup.html#gaef85bcafe5f49ee35b371a52c440207a":[7,0,1,5,39],
 "group__ColorsGroup.html#gaf877c4d11b45c587121e8ef7fcb9adcf":[7,0,1,5,59],
-"group__ColorsGroup.html#gaf879b5c0237118beac4a8dff04c3ce0f":[7,0,1,5,27],
 "group__ColorsGroup.html#gaf879b5c0237118beac4a8dff04c3ce0f":[5,5,27],
+"group__ColorsGroup.html#gaf879b5c0237118beac4a8dff04c3ce0f":[7,0,1,5,27],
 "group__ColorsGroup.html#gaf88547eb95c789cf39fd0dcd5c4a5dbf":[7,0,1,5,49],
-"group__ColorsGroup.html#gaf8c7c3371bab1fcfdde36fb3abba3869":[5,5,17],
 "group__ColorsGroup.html#gaf8c7c3371bab1fcfdde36fb3abba3869":[7,0,1,5,17],
+"group__ColorsGroup.html#gaf8c7c3371bab1fcfdde36fb3abba3869":[5,5,17],
 "group__ColorsGroup.html#gafb0d1e19388b75c77b6fb295e6e42058":[7,0,1,5,54],
 "group__Core1Group.html":[5,11],
 "group__Core1Group.html#ga180966e085ce28347b335bde3d3d09ca":[5,11,2],
@@ -170,10 +170,10 @@ var NAVTREEINDEX1 =
 "group__FontsGroup.html#gaf67d2d341d7031455c9526332cbf962b":[7,0,1,2,67],
 "group__FontsGroup.html#gafdcaab8470c69f1f4a7680667d6228f7":[7,0,1,2,63],
 "group__LayersGroup.html":[5,3],
-"group__LayersGroup.html#ga0da04f300787ea8fb6d282a06696e00b":[5,3,20],
 "group__LayersGroup.html#ga0da04f300787ea8fb6d282a06696e00b":[7,0,1,1,20],
-"group__LayersGroup.html#ga14983620b33323dc5e9ad4c2f59a2674":[5,3,21],
+"group__LayersGroup.html#ga0da04f300787ea8fb6d282a06696e00b":[5,3,20],
 "group__LayersGroup.html#ga14983620b33323dc5e9ad4c2f59a2674":[7,0,1,1,21],
+"group__LayersGroup.html#ga14983620b33323dc5e9ad4c2f59a2674":[5,3,21],
 "group__LayersGroup.html#ga2643e48ca17a8b7fcedab422104efd7e":[5,3,16],
 "group__LayersGroup.html#ga2643e48ca17a8b7fcedab422104efd7e":[7,0,1,1,16],
 "group__LayersGroup.html#ga287d940367f5bf5ab746c8abe8d063c7":[5,3,23],
@@ -200,8 +200,8 @@ var NAVTREEINDEX1 =
 "group__LayersGroup.html#ga5af95ed8e8967ef12787636b6b902924":[7,0,1,1,4],
 "group__LayersGroup.html#ga5da28651c3f331949810672da020b133":[5,3,28],
 "group__LayersGroup.html#ga5da28651c3f331949810672da020b133":[7,0,1,1,28],
-"group__LayersGroup.html#ga61636dd304a9b6a1569de441b7f347fa":[7,0,1,1,7],
 "group__LayersGroup.html#ga61636dd304a9b6a1569de441b7f347fa":[5,3,7],
+"group__LayersGroup.html#ga61636dd304a9b6a1569de441b7f347fa":[7,0,1,1,7],
 "group__LayersGroup.html#ga62b72ae320dd472ba5b900e0887adc47":[7,0,1,4,31],
 "group__LayersGroup.html#ga62b72ae320dd472ba5b900e0887adc47":[5,3,40],
 "group__LayersGroup.html#ga6b80789b0fbfc305e1bd8974b89bd180":[7,0,1,4,14],
@@ -212,8 +212,8 @@ var NAVTREEINDEX1 =
 "group__LayersGroup.html#ga73f7e2111375c89d1df33b941154c9a4":[7,0,1,1,24],
 "group__LayersGroup.html#ga7c7fb76948995d9fcc13e39732a29081":[7,0,1,1,9],
 "group__LayersGroup.html#ga7c7fb76948995d9fcc13e39732a29081":[5,3,9],
-"group__LayersGroup.html#ga7dddc715d66753f8907c7fd31259d5e8":[7,0,1,4,13],
 "group__LayersGroup.html#ga7dddc715d66753f8907c7fd31259d5e8":[5,3,32],
+"group__LayersGroup.html#ga7dddc715d66753f8907c7fd31259d5e8":[7,0,1,4,13],
 "group__LayersGroup.html#ga7de97bc16e3da10d03796876b3132877":[7,0,1,1,5],
 "group__LayersGroup.html#ga7de97bc16e3da10d03796876b3132877":[5,3,5],
 "group__LayersGroup.html#ga82cb899eedcf1830412578e4d2120982":[5,3,18],
@@ -224,18 +224,18 @@ var NAVTREEINDEX1 =
 "group__LayersGroup.html#ga92bfc711a47d3e3db9d4f014b1a0ece4":[7,0,1,1,22],
 "group__LayersGroup.html#ga99aa7a28b0927e1f21411733b2f97fb5":[7,0,1,4,15],
 "group__LayersGroup.html#ga99aa7a28b0927e1f21411733b2f97fb5":[5,3,34],
-"group__LayersGroup.html#gaa1c2d870b2d7a0a7a2c2341183342b21":[7,0,1,1,3],
 "group__LayersGroup.html#gaa1c2d870b2d7a0a7a2c2341183342b21":[5,3,3],
+"group__LayersGroup.html#gaa1c2d870b2d7a0a7a2c2341183342b21":[7,0,1,1,3],
 "group__LayersGroup.html#gaa1d27c8389336e9cb8f898a32e3ddf49":[5,3,14],
 "group__LayersGroup.html#gaa1d27c8389336e9cb8f898a32e3ddf49":[7,0,1,1,14],
 "group__LayersGroup.html#gaa877ccc48068be12c150aee8be6d8d61":[7,0,1,4,30],
 "group__LayersGroup.html#gaa877ccc48068be12c150aee8be6d8d61":[5,3,39],
 "group__LayersGroup.html#gab09c202d0ab364d040ca7ae19c26b909":[5,3,25],
 "group__LayersGroup.html#gab09c202d0ab364d040ca7ae19c26b909":[7,0,1,1,25],
-"group__LayersGroup.html#gab14875f1e26da3948ae9b943505130d6":[7,0,1,1,12],
 "group__LayersGroup.html#gab14875f1e26da3948ae9b943505130d6":[5,3,12],
-"group__LayersGroup.html#gab152ba7d55b966804711247ebac62b3a":[5,3,10],
+"group__LayersGroup.html#gab14875f1e26da3948ae9b943505130d6":[7,0,1,1,12],
 "group__LayersGroup.html#gab152ba7d55b966804711247ebac62b3a":[7,0,1,1,10],
+"group__LayersGroup.html#gab152ba7d55b966804711247ebac62b3a":[5,3,10],
 "group__LayersGroup.html#gabca5b092d4f3af2a33cf67201c19155c":[7,0,1,1,17],
 "group__LayersGroup.html#gabca5b092d4f3af2a33cf67201c19155c":[5,3,17],
 "group__LayersGroup.html#gac97aa4e68f9c89b8c71d011b0956de1f":[7,0,1,1,2],
@@ -244,8 +244,8 @@ var NAVTREEINDEX1 =
 "group__LayersGroup.html#gad69e79889f842c7e6b9d9bd2086b619d":[5,3,11],
 "group__LayersGroup.html#gae652a56aab6bb8379ffa0ea9cbe50f57":[7,0,1,1,6],
 "group__LayersGroup.html#gae652a56aab6bb8379ffa0ea9cbe50f57":[5,3,6],
-"group__LayersGroup.html#gaf236b6b45739cbf708297f44278abf90":[7,0,1,1,8],
 "group__LayersGroup.html#gaf236b6b45739cbf708297f44278abf90":[5,3,8],
+"group__LayersGroup.html#gaf236b6b45739cbf708297f44278abf90":[7,0,1,1,8],
 "group__LayersGroup.html#gaf58ec226682fcb7d0b92d246ba23b38f":[5,3,29],
 "group__LayersGroup.html#gaf58ec226682fcb7d0b92d246ba23b38f":[7,0,1,1,29],
 "group__LayersGroup.html#gaf95ad14e461311fde045530e4fbc8c9f":[7,0,1,4,12],
--- a/docs/navtreeindex2.js
+++ b/docs/navtreeindex2.js
@@ -21,14 +21,14 @@ var NAVTREEINDEX2 =
 "group__PWMGroup.html#gaf9f5fbc637ae75e22d2f628cbfd9b665":[7,0,1,0,4,13],
 "group__PWMGroup.html#gaf9f5fbc637ae75e22d2f628cbfd9b665":[5,9,5],
 "group__RandomGroup.html":[5,10],
-"group__RandomGroup.html#ga0580bc155d11536ce235db6fb52ae33c":[7,0,1,0,5,15],
 "group__RandomGroup.html#ga0580bc155d11536ce235db6fb52ae33c":[5,10,18],
+"group__RandomGroup.html#ga0580bc155d11536ce235db6fb52ae33c":[7,0,1,0,5,15],
 "group__RandomGroup.html#ga102f03a6daebe8b0dda720c69dd01a85":[5,10,19],
 "group__RandomGroup.html#ga102f03a6daebe8b0dda720c69dd01a85":[7,0,1,0,5,16],
-"group__RandomGroup.html#ga151bf25e89de011b14c29fe38400bab0":[7,0,1,0,5,13],
 "group__RandomGroup.html#ga151bf25e89de011b14c29fe38400bab0":[5,10,16],
-"group__RandomGroup.html#ga1b3a9c6d4ac9c9c5e05449fd5db108af":[5,10,25],
+"group__RandomGroup.html#ga151bf25e89de011b14c29fe38400bab0":[7,0,1,0,5,13],
 "group__RandomGroup.html#ga1b3a9c6d4ac9c9c5e05449fd5db108af":[7,0,1,0,5,22],
+"group__RandomGroup.html#ga1b3a9c6d4ac9c9c5e05449fd5db108af":[5,10,25],
 "group__RandomGroup.html#ga1f6686911738e8d5973d8732311b9174":[5,10,41],
 "group__RandomGroup.html#ga1f6686911738e8d5973d8732311b9174":[7,0,1,0,5,38],
 "group__RandomGroup.html#ga1fb30520196dc9cd1617d05f43b4d91f":[5,10,27],
@@ -83,10 +83,10 @@ var NAVTREEINDEX2 =
 "group__RandomGroup.html#gaaf56c591f0c31fa8844fec716d9ae0b0":[5,10,9],
 "group__RandomGroup.html#gaaf58bbb6ea1aa045c6dc5a09e14d08a8":[7,0,1,0,5,36],
 "group__RandomGroup.html#gaaf58bbb6ea1aa045c6dc5a09e14d08a8":[5,10,39],
-"group__RandomGroup.html#gaaff062ea558f1f84b660ed683a62b3be":[5,10,34],
 "group__RandomGroup.html#gaaff062ea558f1f84b660ed683a62b3be":[7,0,1,0,5,31],
-"group__RandomGroup.html#gab5b9f1ff786b4d4e953b6368a2092789":[7,0,1,0,5,26],
+"group__RandomGroup.html#gaaff062ea558f1f84b660ed683a62b3be":[5,10,34],
 "group__RandomGroup.html#gab5b9f1ff786b4d4e953b6368a2092789":[5,10,29],
+"group__RandomGroup.html#gab5b9f1ff786b4d4e953b6368a2092789":[7,0,1,0,5,26],
 "group__RandomGroup.html#gac8dda90ba8f66ef7cef223c0b928d8e6":[5,10,21],
 "group__RandomGroup.html#gac8dda90ba8f66ef7cef223c0b928d8e6":[7,0,1,0,5,18],
 "group__RandomGroup.html#gad5c7e52ca2c03cabe9d7cf6506553860":[5,10,31],
@@ -95,8 +95,8 @@ var NAVTREEINDEX2 =
 "group__RandomGroup.html#gad5d0dd2bd3d638c1c129d17a317bf99a":[5,10,5],
 "group__RandomGroup.html#gad7b52ed9e7d32319778077a9086b7d61":[7,0,1,0,5,7],
 "group__RandomGroup.html#gad7b52ed9e7d32319778077a9086b7d61":[5,10,10],
-"group__RandomGroup.html#gad94693d3f4366b6aa4df3e4b8ed6c9c9":[7,0,1,0,5,33],
 "group__RandomGroup.html#gad94693d3f4366b6aa4df3e4b8ed6c9c9":[5,10,36],
+"group__RandomGroup.html#gad94693d3f4366b6aa4df3e4b8ed6c9c9":[7,0,1,0,5,33],
 "group__RandomGroup.html#gae0e7b6df0672d3ed4bd0f006aaa8a433":[5,10,24],
 "group__RandomGroup.html#gae0e7b6df0672d3ed4bd0f006aaa8a433":[7,0,1,0,5,21],
 "group__RandomGroup.html#gae6fe4d963031879338bc2e6419585b86":[7,0,1,0,5,35],
@@ -105,8 +105,8 @@ var NAVTREEINDEX2 =
 "group__RandomGroup.html#gaf10b875dc0e70b5a89e5e4cbbc2d1bca":[5,10,42],
 "group__RandomGroup.html#gafbe11ff06dbc741744c240a5ec813c1a":[7,0,1,0,5,11],
 "group__RandomGroup.html#gafbe11ff06dbc741744c240a5ec813c1a":[5,10,14],
-"group__RandomGroup.html#gafd0ab6e19e841f2e91d0bd414372cf34":[7,0,1,0,5,23],
 "group__RandomGroup.html#gafd0ab6e19e841f2e91d0bd414372cf34":[5,10,26],
+"group__RandomGroup.html#gafd0ab6e19e841f2e91d0bd414372cf34":[7,0,1,0,5,23],
 "group__ScreenGroup.html":[5,2],
 "group__ScreenGroup.html#ga032c5a372e2ff20f012097deaf1557d6":[7,0,1,6,26],
 "group__ScreenGroup.html#ga032c5a372e2ff20f012097deaf1557d6":[5,2,29],
@@ -130,30 +130,30 @@ var NAVTREEINDEX2 =
 "group__ScreenGroup.html#ga46604c7b349607634cc7a447a58d1daf":[5,2,17],
 "group__ScreenGroup.html#ga49a3e79f7c5d1bbeec72b66985c0bc6a":[7,0,1,6,30],
 "group__ScreenGroup.html#ga49a3e79f7c5d1bbeec72b66985c0bc6a":[5,2,33],
-"group__ScreenGroup.html#ga4df2e7522b0f9c0e996cccbfb0a4ace6":[5,2,7],
 "group__ScreenGroup.html#ga4df2e7522b0f9c0e996cccbfb0a4ace6":[7,0,1,6,4],
+"group__ScreenGroup.html#ga4df2e7522b0f9c0e996cccbfb0a4ace6":[5,2,7],
 "group__ScreenGroup.html#ga5de2fa720bb6488ff4aaf868bb6c272c":[7,0,1,6,19],
 "group__ScreenGroup.html#ga5de2fa720bb6488ff4aaf868bb6c272c":[5,2,22],
 "group__ScreenGroup.html#ga6132ac135c0097ff77e46500727cf80a":[7,0,1,6,6],
 "group__ScreenGroup.html#ga6132ac135c0097ff77e46500727cf80a":[5,2,9],
-"group__ScreenGroup.html#ga63c742a5535d26ecdf6d85f3d9b9d5ff":[5,2,10],
 "group__ScreenGroup.html#ga63c742a5535d26ecdf6d85f3d9b9d5ff":[7,0,1,6,7],
+"group__ScreenGroup.html#ga63c742a5535d26ecdf6d85f3d9b9d5ff":[5,2,10],
 "group__ScreenGroup.html#ga6621d6bc2191e53ef7c66db1514ff9c3":[7,0,1,6,35],
 "group__ScreenGroup.html#ga6621d6bc2191e53ef7c66db1514ff9c3":[5,2,38],
-"group__ScreenGroup.html#ga6658bae842b00873fbd81ff314e885f2":[7,0,1,6,23],
 "group__ScreenGroup.html#ga6658bae842b00873fbd81ff314e885f2":[5,2,26],
-"group__ScreenGroup.html#ga7f08ce542135baab110f2b51100dd1ae":[7,0,1,6,20],
+"group__ScreenGroup.html#ga6658bae842b00873fbd81ff314e885f2":[7,0,1,6,23],
 "group__ScreenGroup.html#ga7f08ce542135baab110f2b51100dd1ae":[5,2,23],
-"group__ScreenGroup.html#ga8b1e1ec0a803677fccc326613f58fedd":[7,0,1,6,8],
+"group__ScreenGroup.html#ga7f08ce542135baab110f2b51100dd1ae":[7,0,1,6,20],
 "group__ScreenGroup.html#ga8b1e1ec0a803677fccc326613f58fedd":[5,2,11],
+"group__ScreenGroup.html#ga8b1e1ec0a803677fccc326613f58fedd":[7,0,1,6,8],
 "group__ScreenGroup.html#ga90863ea08105ea7aed367cd6f1626251":[7,0,1,6,33],
 "group__ScreenGroup.html#ga90863ea08105ea7aed367cd6f1626251":[5,2,36],
-"group__ScreenGroup.html#ga91307fe494a56bdc90abe81fd29c883b":[5,2,30],
 "group__ScreenGroup.html#ga91307fe494a56bdc90abe81fd29c883b":[7,0,1,6,27],
+"group__ScreenGroup.html#ga91307fe494a56bdc90abe81fd29c883b":[5,2,30],
 "group__ScreenGroup.html#ga9c8a0032cf1145c5a6c369193a134a78":[7,0,1,6,36],
 "group__ScreenGroup.html#ga9c8a0032cf1145c5a6c369193a134a78":[5,2,39],
-"group__ScreenGroup.html#gaa87f4ccef65edf82ea94f1f00dcff88e":[5,2,4],
 "group__ScreenGroup.html#gaa87f4ccef65edf82ea94f1f00dcff88e":[7,0,1,6,1],
+"group__ScreenGroup.html#gaa87f4ccef65edf82ea94f1f00dcff88e":[5,2,4],
 "group__ScreenGroup.html#gaabefa0d870166b1d755eca211dd5167e":[7,0,1,6,16],
 "group__ScreenGroup.html#gaabefa0d870166b1d755eca211dd5167e":[5,2,19],
 "group__ScreenGroup.html#gab20230d462f0d84f3bff123192b97faa":[5,2,5],
@@ -166,8 +166,8 @@ var NAVTREEINDEX2 =
 "group__ScreenGroup.html#gabfce65d432ba3ba23b9e9d26cb7e0833":[7,0,1,6,21],
 "group__ScreenGroup.html#gac6b3d9370076b7815b6e93cc8dd1331a":[7,0,1,6,28],
 "group__ScreenGroup.html#gac6b3d9370076b7815b6e93cc8dd1331a":[5,2,31],
-"group__ScreenGroup.html#gac9f53f0344affb6b5f4f11484c22772f":[5,2,20],
 "group__ScreenGroup.html#gac9f53f0344affb6b5f4f11484c22772f":[7,0,1,6,17],
+"group__ScreenGroup.html#gac9f53f0344affb6b5f4f11484c22772f":[5,2,20],
 "group__ScreenGroup.html#gaccae48338e65347201543eed10bdcb3f":[7,0,1,6,32],
 "group__ScreenGroup.html#gaccae48338e65347201543eed10bdcb3f":[5,2,35],
 "group__ScreenGroup.html#gacf69e978d287eff0f18d30c4c77a2e42":[5,2,6],
@@ -183,12 +183,12 @@ var NAVTREEINDEX2 =
 "group__ScreenGroup.html#gaff0df01b94efb9c244ee3c91883503be":[7,0,1,6,34],
 "group__ScreenGroup.html#gaff0df01b94efb9c244ee3c91883503be":[5,2,37],
 "group__SpriteGroup.html":[5,4],
-"group__SpriteGroup.html#ga3335f2de0489fb2ceaa2641822b37872":[5,4,0],
 "group__SpriteGroup.html#ga3335f2de0489fb2ceaa2641822b37872":[7,0,1,4,20],
-"group__SpriteGroup.html#ga63d71d933e8f5e7b47b139f61d1186fe":[7,0,1,4,21],
+"group__SpriteGroup.html#ga3335f2de0489fb2ceaa2641822b37872":[5,4,0],
 "group__SpriteGroup.html#ga63d71d933e8f5e7b47b139f61d1186fe":[5,4,1],
-"group__SpriteGroup.html#gaee253aa5119f5c51858b19fb65843fc2":[7,0,1,4,22],
+"group__SpriteGroup.html#ga63d71d933e8f5e7b47b139f61d1186fe":[7,0,1,4,21],
 "group__SpriteGroup.html#gaee253aa5119f5c51858b19fb65843fc2":[5,4,2],
+"group__SpriteGroup.html#gaee253aa5119f5c51858b19fb65843fc2":[7,0,1,4,22],
 "group__TextGroup.html":[5,8],
 "group__TextGroup.html#ga010d965d1d792c724fc768985d4198ae":[7,0,1,0,3,3],
 "group__TextGroup.html#ga0275c150a5a12613afaef51f4bec2c89":[7,0,1,0,3,31],
@@ -201,11 +201,11 @@ var NAVTREEINDEX2 =
 "group__TextGroup.html#ga12173cbbd75ec81eb3b42bce55a8da38":[7,0,1,0,3,15],
 "group__TextGroup.html#ga1526153f29404eae222b6f97b4836ae6":[7,0,1,0,3,29],
 "group__TextGroup.html#ga1526153f29404eae222b6f97b4836ae6":[5,8,7],
-"group__TextGroup.html#ga16e185e12dd782e3b69117386fe64dc9":[7,0,1,0,3,44],
 "group__TextGroup.html#ga16e185e12dd782e3b69117386fe64dc9":[5,8,22],
+"group__TextGroup.html#ga16e185e12dd782e3b69117386fe64dc9":[7,0,1,0,3,44],
 "group__TextGroup.html#ga20011acc623c0052528f04b74892731e":[7,0,1,0,3,47],
-"group__TextGroup.html#ga2323e69f1ff2adaadf317eb220bd10db":[5,8,24],
 "group__TextGroup.html#ga2323e69f1ff2adaadf317eb220bd10db":[7,0,1,0,3,46],
+"group__TextGroup.html#ga2323e69f1ff2adaadf317eb220bd10db":[5,8,24],
 "group__TextGroup.html#ga2e2d5c4e3853bb453de7e5d7e35e42f1":[7,0,1,0,3,48],
 "group__TextGroup.html#ga31d3889295234317d3fa01344c175f56":[7,0,1,0,3,52],
 "group__TextGroup.html#ga351c19309ced4dc9310112ad2b8bae2c":[7,0,1,0,3,43],
@@ -235,16 +235,16 @@ var NAVTREEINDEX2 =
 "group__TextGroup.html#ga96f70aecaff003e01fc8bcf2f070c5ef":[7,0,1,0,3,19],
 "group__TextGroup.html#ga9736253678da381b7d0e76feb155ef4b":[7,0,1,0,3,28],
 "group__TextGroup.html#ga9736253678da381b7d0e76feb155ef4b":[5,8,6],
-"group__TextGroup.html#ga9794804d1b01d51df73144d3edc0150d":[7,0,1,0,3,40],
 "group__TextGroup.html#ga9794804d1b01d51df73144d3edc0150d":[5,8,18],
+"group__TextGroup.html#ga9794804d1b01d51df73144d3edc0150d":[7,0,1,0,3,40],
 "group__TextGroup.html#ga9e978a6f4f39f4eed02c2a7d141ecb31":[7,0,1,0,3,4],
 "group__TextGroup.html#ga9f8002fe998f4571ae630bb9cb800d76":[7,0,1,0,3,17],
 "group__TextGroup.html#gaacbc5582970215447f0f6542edf77e07":[7,0,1,0,3,18],
 "group__TextGroup.html#gab278969e0bc4296056adb7b18aa43227":[7,0,1,0,3,20],
 "group__TextGroup.html#gab86c5f1af32c36d86b3d16f54dd5e0c9":[7,0,1,0,3,23],
 "group__TextGroup.html#gab86c5f1af32c36d86b3d16f54dd5e0c9":[5,8,1],
-"group__TextGroup.html#gab9231ede9d6a979f1b812b7667c34d29":[5,8,19],
 "group__TextGroup.html#gab9231ede9d6a979f1b812b7667c34d29":[7,0,1,0,3,41],
+"group__TextGroup.html#gab9231ede9d6a979f1b812b7667c34d29":[5,8,19],
 "group__TextGroup.html#gaba693e4bd43c731c3c97ca303938a903":[7,0,1,0,3,35],
 "group__TextGroup.html#gaba693e4bd43c731c3c97ca303938a903":[5,8,13],
 "group__TextGroup.html#gac0e5fdce3dbb507e6a059a22a595d97f":[7,0,1,0,3,5],
--- a/docs/navtreeindex3.js
+++ b/docs/navtreeindex3.js
@@ -3,12 +3,12 @@ var NAVTREEINDEX3 =
 "group__TextGroup.html#gac91910c7276ceff7cb48fa6733a1e343":[7,0,1,0,3,11],
 "group__TextGroup.html#gacdf79045593025b8b51f841dd696094d":[7,0,1,0,3,34],
 "group__TextGroup.html#gacdf79045593025b8b51f841dd696094d":[5,8,12],
-"group__TextGroup.html#gad1928b0e991c50af34ed239e9bcec9fe":[5,8,3],
 "group__TextGroup.html#gad1928b0e991c50af34ed239e9bcec9fe":[7,0,1,0,3,25],
+"group__TextGroup.html#gad1928b0e991c50af34ed239e9bcec9fe":[5,8,3],
 "group__TextGroup.html#gad43a32dad63df05f21d3b2254c96f36d":[7,0,1,0,3,38],
 "group__TextGroup.html#gad43a32dad63df05f21d3b2254c96f36d":[5,8,16],
-"group__TextGroup.html#gad7b697700b999077439e537a2fef28f3":[7,0,1,0,3,32],
 "group__TextGroup.html#gad7b697700b999077439e537a2fef28f3":[5,8,10],
+"group__TextGroup.html#gad7b697700b999077439e537a2fef28f3":[7,0,1,0,3,32],
 "group__TextGroup.html#gadcccad3a7f535942d3a5d6b7a34f3759":[7,0,1,0,3,12],
 "group__TextGroup.html#gade5cb618d219cfff20fabcb1e3f6dc02":[7,0,1,0,3,2],
 "group__TextGroup.html#gade60ad2cd29a6fa7732f56137d8d5eac":[7,0,1,0,3,16],
@@ -79,26 +79,26 @@ var NAVTREEINDEX3 =
 "group__UtilsGroup.html":[5,12],
 "group__UtilsGroup.html#ga268e6976f0e415330c26c1f3d4d73cc9":[5,12,2],
 "group__UtilsGroup.html#ga268e6976f0e415330c26c1f3d4d73cc9":[7,0,1,7,2],
-"group__UtilsGroup.html#ga31e41cec17ed79dc0bd026b6d45237a0":[7,0,1,7,4],
 "group__UtilsGroup.html#ga31e41cec17ed79dc0bd026b6d45237a0":[5,12,4],
+"group__UtilsGroup.html#ga31e41cec17ed79dc0bd026b6d45237a0":[7,0,1,7,4],
 "group__UtilsGroup.html#ga49a4978da9e0f15dcdc9ebfc9d6c520e":[7,0,1,7,5],
 "group__UtilsGroup.html#ga49a4978da9e0f15dcdc9ebfc9d6c520e":[5,12,5],
 "group__UtilsGroup.html#ga6d2664ea6a63954346a80ca93cfb3b74":[7,0,1,7,3],
 "group__UtilsGroup.html#ga6d2664ea6a63954346a80ca93cfb3b74":[5,12,3],
-"group__UtilsGroup.html#ga9d2f98a08bf609f9969298eb2e9d7761":[5,12,1],
 "group__UtilsGroup.html#ga9d2f98a08bf609f9969298eb2e9d7761":[7,0,1,7,1],
-"group__UtilsGroup.html#gab8207741ed267ed4fbaa28c4d5a7bad9":[7,0,1,7,0],
+"group__UtilsGroup.html#ga9d2f98a08bf609f9969298eb2e9d7761":[5,12,1],
 "group__UtilsGroup.html#gab8207741ed267ed4fbaa28c4d5a7bad9":[5,12,0],
+"group__UtilsGroup.html#gab8207741ed267ed4fbaa28c4d5a7bad9":[7,0,1,7,0],
 "group__VideoInitGroup.html":[5,0],
-"group__VideoInitGroup.html#ga0e413f66204b739fdcc8c675b9226d5b":[5,0,1],
 "group__VideoInitGroup.html#ga0e413f66204b739fdcc8c675b9226d5b":[7,0,1,3,22],
-"group__VideoInitGroup.html#ga635c059231b4b8c8bbf4162a9044fcd6":[7,0,1,3,21],
+"group__VideoInitGroup.html#ga0e413f66204b739fdcc8c675b9226d5b":[5,0,1],
 "group__VideoInitGroup.html#ga635c059231b4b8c8bbf4162a9044fcd6":[5,0,0],
-"group__VideoInitGroup.html#gae078675a223061bd05b22421d091fcc4":[5,0,2],
+"group__VideoInitGroup.html#ga635c059231b4b8c8bbf4162a9044fcd6":[7,0,1,3,21],
 "group__VideoInitGroup.html#gae078675a223061bd05b22421d091fcc4":[7,0,1,8,4],
+"group__VideoInitGroup.html#gae078675a223061bd05b22421d091fcc4":[5,0,2],
 "group__VideoModeGroup.html":[5,1],
-"group__VideoModeGroup.html#ga0ff3ab799ef4e2d47973e8467f80124a":[5,1,16],
 "group__VideoModeGroup.html#ga0ff3ab799ef4e2d47973e8467f80124a":[7,0,1,8,14],
+"group__VideoModeGroup.html#ga0ff3ab799ef4e2d47973e8467f80124a":[5,1,16],
 "group__VideoModeGroup.html#ga2bf2039947f0787eddcbbfb7a290a623":[7,0,1,8,6],
 "group__VideoModeGroup.html#ga2bf2039947f0787eddcbbfb7a290a623":[5,1,8],
 "group__VideoModeGroup.html#ga3a82ed7dd84179f7a94aa8ecb46dd2be":[7,0,1,8,12],
@@ -111,12 +111,12 @@ var NAVTREEINDEX3 =
 "group__VideoModeGroup.html#ga4b445e69b039011d96ef7276777f445c":[5,1,19],
 "group__VideoModeGroup.html#ga5a8c9c954becaf3532bb45f3801ca916":[7,0,1,8,3],
 "group__VideoModeGroup.html#ga5a8c9c954becaf3532bb45f3801ca916":[5,1,6],
-"group__VideoModeGroup.html#ga5c395e6432f802e7d1a57a27359dfb21":[7,0,1,8,1],
 "group__VideoModeGroup.html#ga5c395e6432f802e7d1a57a27359dfb21":[5,1,4],
+"group__VideoModeGroup.html#ga5c395e6432f802e7d1a57a27359dfb21":[7,0,1,8,1],
 "group__VideoModeGroup.html#ga660945232bde72e2d071814b14927786":[5,1,11],
 "group__VideoModeGroup.html#ga660945232bde72e2d071814b14927786":[7,0,1,8,9],
-"group__VideoModeGroup.html#ga6e2829a1d4a0907563173ed5da6607a2":[7,0,1,8,2],
 "group__VideoModeGroup.html#ga6e2829a1d4a0907563173ed5da6607a2":[5,1,5],
+"group__VideoModeGroup.html#ga6e2829a1d4a0907563173ed5da6607a2":[7,0,1,8,2],
 "group__VideoModeGroup.html#ga6f956ea6eda29ad819440c9ec402f519":[5,1,20],
 "group__VideoModeGroup.html#ga6f956ea6eda29ad819440c9ec402f519":[7,0,1,8,18],
 "group__VideoModeGroup.html#ga703cd2c1aaaa2fbabb83b45ea6bd7529":[7,0,1,8,11],
@@ -125,14 +125,14 @@ var NAVTREEINDEX3 =
 "group__VideoModeGroup.html#ga7b78a1e0c925f559b57130c96cb2ab87":[5,1,9],
 "group__VideoModeGroup.html#gab82daa8ff7c1f0a0af98f0a1a2ad8070":[5,1,3],
 "group__VideoModeGroup.html#gab82daa8ff7c1f0a0af98f0a1a2ad8070":[7,0,1,8,0],
-"group__VideoModeGroup.html#gabecd7c08a1f9ed4ca20d37d27324c9f9":[7,0,1,8,16],
 "group__VideoModeGroup.html#gabecd7c08a1f9ed4ca20d37d27324c9f9":[5,1,18],
+"group__VideoModeGroup.html#gabecd7c08a1f9ed4ca20d37d27324c9f9":[7,0,1,8,16],
 "group__VideoModeGroup.html#gadb7e1852e9bacd8022a73300a056597b":[7,0,1,8,10],
 "group__VideoModeGroup.html#gadb7e1852e9bacd8022a73300a056597b":[5,1,12],
-"group__VideoModeGroup.html#gadcbc32ee97d11a2adca51f68cd5d2daa":[5,1,17],
 "group__VideoModeGroup.html#gadcbc32ee97d11a2adca51f68cd5d2daa":[7,0,1,8,15],
-"group__VideoModeGroup.html#gae0a554c910a0813dc34efe6e41c599f0":[7,0,1,8,13],
+"group__VideoModeGroup.html#gadcbc32ee97d11a2adca51f68cd5d2daa":[5,1,17],
 "group__VideoModeGroup.html#gae0a554c910a0813dc34efe6e41c599f0":[5,1,15],
+"group__VideoModeGroup.html#gae0a554c910a0813dc34efe6e41c599f0":[7,0,1,8,13],
 "group__VideoModeGroup.html#gga99fb83031ce9923c84392b4e92f956b5a12e47b6dfb21b1ba0ecdba27e2f68a07":[5,1,3,7],
 "group__VideoModeGroup.html#gga99fb83031ce9923c84392b4e92f956b5a3ac2b2f53a10630b3bb1ed4330849bf6":[5,1,3,1],
 "group__VideoModeGroup.html#gga99fb83031ce9923c84392b4e92f956b5a45e742ff1aa9511cc9c88aee89d66686":[5,1,3,4],
@@ -160,11 +160,12 @@ var NAVTREEINDEX3 =
 "group__VideoModeGroup.html#ggadf764cbdea00d65edcd07bb9953ad2b7a4fdffdf8c8f5e50508fbd327b6443eac":[5,1,3,2],
 "group__VideoModeGroup.html#ggadf764cbdea00d65edcd07bb9953ad2b7afbc7eef2e6768fa471d531d40acb4d7f":[5,1,3,1],
 "hierarchy.html":[6,2],
-"index.html":[],
 "index.html":[0],
+"index.html":[],
 "index.html#autotoc_md10":[0,3],
 "index.html#autotoc_md11":[0,4],
 "index.html#autotoc_md12":[0,5],
+"index.html#autotoc_md13":[0,6],
 "index.html#autotoc_md7":[0,0],
 "index.html#autotoc_md8":[0,1],
 "index.html#autotoc_md9":[0,2],
@@ -248,6 +249,5 @@ var NAVTREEINDEX3 =
 "structsLayer.html#a23de438bb18f13c25cda42f2b87af5b1":[5,3,0,7],
 "structsLayer.html#a26daff2ecab64e079ff060f3b97db230":[5,3,0,16],
 "structsLayer.html#a5ecbd38a6da5261823990fef4b78270c":[5,3,0,4],
-"structsLayer.html#a7a29cd6a22a5e7a2743714cfb14dab7a":[5,3,0,5],
-"structsLayer.html#a7faa17573c513e11a8b2db896faa39c1":[5,3,0,11]
+"structsLayer.html#a7a29cd6a22a5e7a2743714cfb14dab7a":[5,3,0,5]
 };
--- a/docs/navtreeindex4.js
+++ b/docs/navtreeindex4.js
@@ -1,5 +1,6 @@
 var NAVTREEINDEX4 =
 {
+"structsLayer.html#a7faa17573c513e11a8b2db896faa39c1":[5,3,0,11],
 "structsLayer.html#a8cfe006acd74ac0a1266fea6640a01f1":[5,3,0,12],
 "structsLayer.html#a977fddc23e4e5ea1acc1e76b3288cc7d":[5,3,0,1],
 "structsLayer.html#aac0d2680ab5a6103717a36f7db9187f3":[5,3,0,3],
@@ -131,38 +132,38 @@ var NAVTREEINDEX4 =
 "structsVmode.html#afe0b90adc1d51fb91e5d53c0751bd779":[5,1,2,11],
 "structsVmode.html#aff9377d2937304923e661f0baa9502cd":[5,1,2,5],
 "tools.html":[3],
-"tools.html#autotoc_md13":[3,0,0],
-"tools.html#autotoc_md14":[3,0,1],
-"tools.html#autotoc_md15":[3,0,2],
-"tools.html#autotoc_md16":[3,0,3],
-"tools.html#autotoc_md17":[3,1,0],
-"tools.html#autotoc_md18":[3,1,1],
-"tools.html#autotoc_md19":[3,1,2],
-"tools.html#autotoc_md20":[3,1,3],
-"tools.html#autotoc_md21":[3,1,4],
-"tools.html#autotoc_md22":[3,1,5],
-"tools.html#autotoc_md23":[3,2,0],
-"tools.html#autotoc_md24":[3,2,1],
-"tools.html#autotoc_md25":[3,2,1,0],
-"tools.html#autotoc_md26":[3,2,2],
-"tools.html#autotoc_md27":[3,3,0],
-"tools.html#autotoc_md28":[3,3,1],
-"tools.html#autotoc_md29":[3,4,0],
-"tools.html#autotoc_md30":[3,4,1],
+"tools.html#autotoc_md14":[3,0,0],
+"tools.html#autotoc_md15":[3,0,1],
+"tools.html#autotoc_md16":[3,0,2],
+"tools.html#autotoc_md17":[3,0,3],
+"tools.html#autotoc_md18":[3,1,0],
+"tools.html#autotoc_md19":[3,1,1],
+"tools.html#autotoc_md20":[3,1,2],
+"tools.html#autotoc_md21":[3,1,3],
+"tools.html#autotoc_md22":[3,1,4],
+"tools.html#autotoc_md23":[3,1,5],
+"tools.html#autotoc_md24":[3,2,0],
+"tools.html#autotoc_md25":[3,2,1],
+"tools.html#autotoc_md26":[3,2,1,0],
+"tools.html#autotoc_md27":[3,2,2],
+"tools.html#autotoc_md28":[3,3,0],
+"tools.html#autotoc_md29":[3,3,1],
+"tools.html#autotoc_md30":[3,4,0],
+"tools.html#autotoc_md31":[3,4,1],
 "tools.html#palettes":[3,4],
 "tools.html#picovga_img":[3,0],
 "tools.html#picovga_rle":[3,1],
 "tools.html#picovga_snd":[3,2],
 "tools.html#picvovga_pal332":[3,3],
 "usagerules.html":[4],
-"usagerules.html#autotoc_md31":[4,0],
-"usagerules.html#autotoc_md32":[4,1],
-"usagerules.html#autotoc_md33":[4,2],
-"usagerules.html#autotoc_md34":[4,3],
-"usagerules.html#autotoc_md35":[4,4],
-"usagerules.html#autotoc_md36":[4,5],
-"usagerules.html#autotoc_md37":[4,6],
-"usagerules.html#autotoc_md38":[4,7],
+"usagerules.html#autotoc_md32":[4,0],
+"usagerules.html#autotoc_md33":[4,1],
+"usagerules.html#autotoc_md34":[4,2],
+"usagerules.html#autotoc_md35":[4,3],
+"usagerules.html#autotoc_md36":[4,4],
+"usagerules.html#autotoc_md37":[4,5],
+"usagerules.html#autotoc_md38":[4,6],
+"usagerules.html#autotoc_md39":[4,7],
 "version_8h_source.html":[7,0,0,0,0,1],
 "vga_8h.html":[7,0,1,3],
 "vga_8h.html#a01ffd103b32679230ed06cbd13e8ad5c":[7,0,1,3,33],
--- a/docs/tools.html
+++ b/docs/tools.html
@@ -105,7 +105,7 @@ $(document).ready(function(){initNavTree('tools.html',''); initResizable(); });
 <h1><a class="anchor" id="picovga_img"></a>
 Image Conversion Tool</h1>
 <p><code>picovga_img</code> is a command-line utility that converts Windows BMP images into C array data for use with the PicoVGA library on the Raspberry Pi Pico. It ensures that images are properly formatted and optimized for 8-bit, 4-bit, 2-bit, or 1-bit palette graphics.</p>
-<h2><a class="anchor" id="autotoc_md13"></a>
+<h2><a class="anchor" id="autotoc_md14"></a>
 Usage</h2>
 <div class="fragment"><div class="line">picovga_img input.bmp output.cpp arrayname</div>
 </div><!-- fragment --><ul>
@@ -117,7 +117,7 @@ Usage</h2>
 </li>
 </ul>
 <p>The tool reads the BMP image, validates its format, and writes the pixel data into a <code>const u8[]</code> array that can be directly included in PicoVGA projects.</p>
-<h2><a class="anchor" id="autotoc_md14"></a>
+<h2><a class="anchor" id="autotoc_md15"></a>
 Supported Image Formats</h2>
 <ul>
 <li><b>8-bit palette BMP</b> – Uses a 256-color palette. <br  />
@@ -137,7 +137,7 @@ Supported Image Formats</h2>
 <li><b>Saved with flipped row order</b> (so that PicoVGA interprets the image correctly) <br  />
 </li>
 </ul>
-<h2><a class="anchor" id="autotoc_md15"></a>
+<h2><a class="anchor" id="autotoc_md16"></a>
 Palettes</h2>
 <p>When exporting from your image editor, always apply the correct palette (<code>.act</code> files) before saving: <br  />
 </p>
@@ -152,7 +152,7 @@ Palettes</h2>
 </li>
 </ul>
 <p>⚠️ <b>Note:</b> BMP does not natively support 2-bit images. Save as a 4-bit BMP with a 4-color palette, and RaspPicoImg will automatically detect and convert it to 2-bit format.</p>
-<h2><a class="anchor" id="autotoc_md16"></a>
+<h2><a class="anchor" id="autotoc_md17"></a>
 Output</h2>
 <p>The generated <code>.c</code> file contains:</p><ul>
 <li>Image metadata (bit depth, width, height, pitch). <br  />
@@ -171,7 +171,7 @@ Output</h2>
 <h1><a class="anchor" id="picovga_rle"></a>
 RLE Compression Tool</h1>
 <p><code>picovga_rle</code> is a command-line utility that compresses 8-bit PicoVGA images into a run-length encoded (RLE) format suitable for use with the PicoVGA library on the Raspberry Pi Pico. The compression significantly reduces image size while maintaining compatibility with the RLE PIO routines in PicoVGA.</p>
-<h2><a class="anchor" id="autotoc_md17"></a>
+<h2><a class="anchor" id="autotoc_md18"></a>
 Usage</h2>
 <div class="fragment"><div class="line">picovga_rle input.bmp output.c arrayname transparent_color</div>
 </div><!-- fragment --><ul>
@@ -185,7 +185,7 @@ Usage</h2>
 </li>
 </ul>
 <p>The tool reads the BMP image, compresses it using RLE, and outputs a set of C arrays containing both pixel data and row offsets.</p>
-<h2><a class="anchor" id="autotoc_md18"></a>
+<h2><a class="anchor" id="autotoc_md19"></a>
 Input Requirements</h2>
 <ul>
 <li><b>Format:</b> Windows BMP. <br  />
@@ -198,7 +198,7 @@ Input Requirements</h2>
 </li>
 </ul>
 <p>⚠️ If the input image does not meet these conditions, the tool will reject it.</p>
-<h2><a class="anchor" id="autotoc_md19"></a>
+<h2><a class="anchor" id="autotoc_md20"></a>
 Transparency</h2>
 <p>The fourth parameter specifies which color index should be treated as transparent. <br  />
 </p>
@@ -210,7 +210,7 @@ Transparency</h2>
 </ul>
 <p>Example: </p><div class="fragment"><div class="line">picovga_rle sprite.bmp sprite.c mysprite 120</div>
 </div><!-- fragment --><p> This command compresses <code>sprite.bmp</code>, outputs to <code>sprite.c</code>, creates an array named <code>mysprite</code>, and treats color index 120 as transparent.</p>
-<h2><a class="anchor" id="autotoc_md20"></a>
+<h2><a class="anchor" id="autotoc_md21"></a>
 Output</h2>
 <p>The generated <code>.cpp</code> file contains:</p><ul>
 <li><b>Image metadata</b> – format, transparency, width, height, size, and compression ratio. <br  />
@@ -235,7 +235,7 @@ Output</h2>
 <div class="line"><span class="keyword">const</span> u8 mysprite[1536] __attribute__ ((aligned(4))) = {</div>
 <div class="line">    0x34, 0x07, 0x12, 0x56, ...</div>
 <div class="line">};</div>
-</div><!-- fragment --><h2><a class="anchor" id="autotoc_md21"></a>
+</div><!-- fragment --><h2><a class="anchor" id="autotoc_md22"></a>
 Internal Encoding</h2>
 <p>The RLE compression encodes pixel sequences into tokens:</p><ul>
 <li><b>skip</b> – Transparent runs of 2–257 pixels. <br  />
@@ -248,13 +248,13 @@ Internal Encoding</h2>
 </li>
 </ul>
 <p>Each scanline is terminated with an <code>idle</code> command and aligned to 32-bit boundaries for efficient processing on the Pico.</p>
-<h2><a class="anchor" id="autotoc_md22"></a>
+<h2><a class="anchor" id="autotoc_md23"></a>
 Compatibility Warning</h2>
 <p>The compressed output is tightly coupled with the <b>RLE PIO program</b> in PicoVGA. Since the instruction format may change between library versions, <b>always use picovga_rle from the same release as your PicoVGA library</b> to avoid incompatibility issues.</p>
 <h1><a class="anchor" id="picovga_snd"></a>
 Sound Import Tool</h1>
 <p><code>picovga_snd</code> is a command-line utility that converts WAV audio files into C array data for playback with the PicoVGA library on the Raspberry Pi Pico. It ensures that sound effects or music are properly formatted for the Pico’s audio playback routines.</p>
-<h2><a class="anchor" id="autotoc_md23"></a>
+<h2><a class="anchor" id="autotoc_md24"></a>
 Usage</h2>
 <div class="fragment"><div class="line">picovga_snd input.wav output.cpp arrayname</div>
 </div><!-- fragment --><ul>
@@ -266,7 +266,7 @@ Usage</h2>
 </li>
 </ul>
 <p>The tool validates the WAV file format and writes its sample data into a <code>const u8[]</code> array that can be directly included in PicoVGA projects.</p>
-<h2><a class="anchor" id="autotoc_md24"></a>
+<h2><a class="anchor" id="autotoc_md25"></a>
 Input Requirements</h2>
 <p>The input WAV file must meet <b>strict format requirements</b>:</p><ul>
 <li><b>Format:</b> PCM (uncompressed). <br  />
@@ -279,7 +279,7 @@ Input Requirements</h2>
 </li>
 </ul>
 <p>⚠️ If the file does not meet these conditions, the tool will reject it.</p>
-<h3><a class="anchor" id="autotoc_md25"></a>
+<h3><a class="anchor" id="autotoc_md26"></a>
 Recommended Editors</h3>
 <ul>
 <li><b>Audacity</b> (free) – provides full editing and sound effects, and supports exporting WAV in the correct format. <br  />
@@ -288,7 +288,7 @@ Recommended Editors</h3>
 </li>
 </ul>
 <p>These tools allow trimming, resampling, and converting audio to the exact format needed for PicoVGA.</p>
-<h2><a class="anchor" id="autotoc_md26"></a>
+<h2><a class="anchor" id="autotoc_md27"></a>
 Output</h2>
 <p>The generated <code>.cpp</code> file contains:</p><ul>
 <li>A header comment describing the sound format. <br  />
@@ -309,7 +309,7 @@ Output</h2>
 <li><b>2 bits blue (0–3 levels)</b></li>
 </ul>
 <p>This RGB332 format allows compact color representation while providing a broad enough spectrum for retro-style graphics.</p>
-<h2><a class="anchor" id="autotoc_md27"></a>
+<h2><a class="anchor" id="autotoc_md28"></a>
 Output Files</h2>
 <p>When you run <code>picvovga_pal332</code>, it generates two important files:</p>
 <ul>
@@ -326,7 +326,7 @@ Output Files</h2>
 <div class="line">1, #000055, 0, 0, 85</div>
 <div class="line">2, #0000AA, 0, 0, 170</div>
 <div class="line">...</div>
-</div><!-- fragment --><h2><a class="anchor" id="autotoc_md28"></a>
+</div><!-- fragment --><h2><a class="anchor" id="autotoc_md29"></a>
 Usage in Image Editors</h2>
 <ul>
 <li>In <b>Photoshop</b> or <b>GIMP</b>, load <code>pal332.act</code> as the palette before saving your image as an 8-bit BMP. This ensures the image uses the exact PicoVGA colors.</li>
@@ -336,7 +336,7 @@ Usage in Image Editors</h2>
 <h1><a class="anchor" id="palettes"></a>
 Palettes</h1>
 <p>The PicoVGA project includes a set of predefined palettes located in the <code>tools\palettes</code> folder. These palettes (<code>*.act</code> files) can be used in Photoshop, GIMP, or other graphics editors to ensure images match PicoVGA’s supported color sets.</p>
-<h2><a class="anchor" id="autotoc_md29"></a>
+<h2><a class="anchor" id="autotoc_md30"></a>
 Available Palettes</h2>
 <ul>
 <li><code>pal332.act</code> – The primary 8-bit PicoVGA palette. This file defines the 256 standard colors used by PicoVGA. <br  />
@@ -350,7 +350,7 @@ Available Palettes</h2>
 <li><code>pal1.act</code> – Black &amp; white palette for 1-bit images. <br  />
 </li>
 </ul>
-<h2><a class="anchor" id="autotoc_md30"></a>
+<h2><a class="anchor" id="autotoc_md31"></a>
 Palette Details</h2>
 <p>The most important palette is <code>pal332.act</code>, which represents the 3-3-2 bit RGB layout (3 bits red, 3 bits green, 2 bits blue). It is generated by the <code>picovga_pal332</code> tool and comes with an additional CSV file:</p>
 <ul>
--- a/docs/usagerules.html
+++ b/docs/usagerules.html
@@ -91,20 +91,20 @@ $(document).ready(function(){initNavTree('usagerules.html',''); initResizable();
 </div><!--header-->
 <div class="contents">
 <div class="textblock"><p><a class="anchor" id="md_pages_UsageRules"></a> Image generation on the Raspberry Pi Pico with PicoVGA is highly demanding on processor resources. The VGA signal must always be generated on time, which means other processor activities must be carefully designed around it. The following principles are critical for stable and reliable operation of the library:</p>
-<h1><a class="anchor" id="autotoc_md31"></a>
+<h1><a class="anchor" id="autotoc_md32"></a>
 Core Utilization</h1>
 <ul>
 <li>The PicoVGA library always runs on the <b>second core (core 1)</b>, while your application code runs on the <b>first core (core 0)</b>. This separation ensures that rendering does not interfere with your main program logic.</li>
 <li>Rendering can fully saturate core 1, making it unsuitable for other tasks in most cases. Your main program should interact with PicoVGA by writing to frame buffers on core 0, while core 1 continuously handles video output without synchronization overhead.</li>
 <li>In lightweight modes (e.g., 8-bit graphics rendered via DMA transfers), core 1 may have spare capacity. Code dispatched to core 1 through the library should not use interrupts, be careful with the interpolation unit (its state is not preserved by the renderer), and never disable interrupts.</li>
 </ul>
-<h1><a class="anchor" id="autotoc_md32"></a>
+<h1><a class="anchor" id="autotoc_md33"></a>
 Memory Rules</h1>
 <ul>
 <li>All data accessed by PicoVGA (images, fonts, tile patterns, etc.) must be stored in <b>RAM</b>, not flash. Flash memory is too slow and will cause video dropouts.</li>
 <li>If assets are stored in external flash, copy them into a RAM buffer before passing them to the rendering functions.</li>
 </ul>
-<h1><a class="anchor" id="autotoc_md33"></a>
+<h1><a class="anchor" id="autotoc_md34"></a>
 Rendering Performance</h1>
 <ul>
 <li>Some modes (e.g., 8-bit DMA transfers) render very quickly, while others (e.g., sprite rendering in slow mode) are CPU-intensive.</li>
@@ -122,7 +122,7 @@ Rendering Performance</h1>
 </li>
 </ul>
 <p>A good stress test is to render many sprites side by side horizontally, which creates the most demanding case.</p>
-<h1><a class="anchor" id="autotoc_md34"></a>
+<h1><a class="anchor" id="autotoc_md35"></a>
 DMA Considerations</h1>
 <ul>
 <li>PicoVGA uses DMA to stream pixel data into the PIO. Even though the PIO has a TX <b>FIFO</b>, competing DMA traffic can delay the render DMA and cause <b>video dropouts</b>.</li>
@@ -134,14 +134,14 @@ DMA Considerations</h1>
 </li>
 <li>Minimize or schedule other DMA operations so they do not overlap with active rendering.</li>
 </ul>
-<h1><a class="anchor" id="autotoc_md35"></a>
+<h1><a class="anchor" id="autotoc_md36"></a>
 CPU Clock Frequency</h1>
 <ul>
 <li>Before initializing video output, PicoVGA calculates and sets the required system clock frequency to ensure precise timing.</li>
 <li>You should print the calculated frequency to the console at startup to verify configuration.</li>
 <li>You may restrict the library from changing the system clock or limit its range. However, this can make some video modes unavailable or unstable.</li>
 </ul>
-<h1><a class="anchor" id="autotoc_md36"></a>
+<h1><a class="anchor" id="autotoc_md37"></a>
 Memory Alignment</h1>
 <ul>
 <li>Image buffers must be aligned to <b>4 bytes</b> (32-bit words).</li>
@@ -153,13 +153,13 @@ Memory Alignment</h1>
 </ul>
 </li>
 </ul>
-<h1><a class="anchor" id="autotoc_md37"></a>
+<h1><a class="anchor" id="autotoc_md38"></a>
 PIO Usage</h1>
 <ul>
 <li>PicoVGA exclusively uses <b>PIO0</b> for video output.</li>
 <li>The second controller, <b>PIO1</b>, remains free and can be used for other purposes in your program.</li>
 </ul>
-<h1><a class="anchor" id="autotoc_md38"></a>
+<h1><a class="anchor" id="autotoc_md39"></a>
 Summary</h1>
 <p>To use PicoVGA effectively:</p><ol type="1">
 <li>Treat core 1 as dedicated to rendering. <br  />
--- a/pages/Index.md
+++ b/pages/Index.md
@@ -48,6 +48,12 @@ For more information on connecting the Pico to a VGA display, check out the **Co

 * [Connections](@ref connections)

+## Tools
+
+The `tools` folder contains the support programs used to prepare images, palettes, and sounds for use with the **PicoVGA** library.
+
+* [Tools and Palettes](@ref tools)
+
 ## License terms

 The PicoVGA library source code and the PicoVGA library sample programs are freely available for further use and modifications. This does not apply to certain graphics and sounds (such as the sounds in Pac-Man) and scene definitions in Sokoban, as these are subject to third party copyrights and may be subject to different distribution terms.