Completed PotreeDesktop section

- Added screenshot
- Updated section with info about pointcloud conversion

docs/_build/html/_sources/pages/potree.rst.txt

@@ -43,7 +43,25 @@ The Potree GUI is made of 2 components:
 * **Sidebar**: on the left, it includes all the main features and tools for point-clouds elaborations in the Potree environment.
 * **Viewer**: on the right, it is the actual space for visually exploring and navigating the point-clouds.
 
-// UNDER CONSTRUCTION //
+Pointcloud conversion
++++++++++++++++++++++
+
+PotreeDesktop provides also a user-friendly interface for converting pointclouds in a Potree-compatible format. In order to do this, you can simply drag&drop the desired poincloud file (in a .las/.laz format) inside the viewer window.
+In a new window, after checking that the output target folder and the input files directory are defined as desired, it is required to select the PotreeConverter version to be adopted for the processing.
+Version 2.0 is the suggested one, generating only 3 files instead of thousands to millions. Click on the *Start Conversion* button to continue.
+
+.. image:: img/potree-desktop-conversion.PNG
+  :align: center
+  :alt: Potree Desktop Conversion selection
+
+After the processing, the pointcloud is loaded in the viewer and the converted files are available in the previously defined output target directory.
+
+.. image:: img/potree-desktop-output.PNG
+  :align: center
+  :alt: Potree Desktop Converted pointcloud visualisation
+
+
+"""""""""""""""""""""""""""""""""""""""""""""""
 
 Potree Converter
 ----------------
@@ -80,22 +98,33 @@ In order to trigger the conversion, modify the following code according to your
 
   .\PotreeConverter.exe pointcloud.las -o output -p index
 
-"""""""""""""""""""""""""""""""""""""""""""""""
-
 Where:
 
 * *PotreeConverter.exe* specify the executable file for the convertion;
 * *pointcloud.las* select the point cloud (las or laz) to be converter. This format is valid in case the point cloud file is located in the same folder of the converter exe. Otherwise it is necessary to specify the complete path of the file;
 * *output* is the name of the directory where to save the converted point cloud. In this case too, if the target folder is outside the converter one, it is necessary to specify the entire path.
 * *index* is the default name to be given to the output file.
 
+After launching, the conversion is executed and details about each step of the the processing are reported on the cmd shell window.
+
+.. image:: img/potree-converter-conversion-details.PNG
+  :align: center
+  :alt: Potree Converter - Conversion details output
+
+If successful, the conversion procedure gives as output a folder named as defined in the command (in this case *output*) containing 3 elements:
+
+1. a folder named **libs** that contains all the required libraries and scripts to make Potree operative (e.g. *three.js*, *openlayers*...);
+2. a folder named **pointclouds** containing an **index** directory that collects that 4 files resulting from the conversion of the original pointclouds. The *metadata.json* is the file called in the Potree environment when loading the pointcloud to the scene;
+3. an html file called **index.html** that includes a basic structure for a web page with a Potree viewer.
 
 Publications
 ++++++++++++
 
 * `Potree: Rendering Large Point Clouds in Web Browsers. <https://www.cg.tuwien.ac.at/research/publications/2016/SCHUETZ-2016-POT/SCHUETZ-2016-POT-thesis.pdf>`__
 * `Fast Out-of-Core Octree Generation for Massive Point Clouds <https://www.cg.tuwien.ac.at/research/publications/2020/SCHUETZ-2020-MPC/>`__, Schütz M., Ohrhallinger S., Wimmer M.
 
+"""""""""""""""""""""""""""""""""""""""""""""""
+
 Potree Develop
 --------------
 

docs/_build/html/pages/potree.html

@@ -64,9 +64,18 @@ <h3>Graphic User Interface<a class="headerlink" href="#graphic-user-interface" t
 <li><p><strong>Sidebar</strong>: on the left, it includes all the main features and tools for point-clouds elaborations in the Potree environment.</p></li>
 <li><p><strong>Viewer</strong>: on the right, it is the actual space for visually exploring and navigating the point-clouds.</p></li>
 </ul>
-<p>// UNDER CONSTRUCTION //</p>
 </section>
+<section id="pointcloud-conversion">
+<h3>Pointcloud conversion<a class="headerlink" href="#pointcloud-conversion" title="Permalink to this heading">¶</a></h3>
+<p>PotreeDesktop provides also a user-friendly interface for converting pointclouds in a Potree-compatible format. In order to do this, you can simply drag&amp;drop the desired poincloud file (in a .las/.laz format) inside the viewer window.
+In a new window, after checking that the output target folder and the input files directory are defined as desired, it is required to select the PotreeConverter version to be adopted for the processing.
+Version 2.0 is the suggested one, generating only 3 files instead of thousands to millions. Click on the <em>Start Conversion</em> button to continue.</p>
+<img alt="Potree Desktop Conversion selection" class="align-center" src="../_images/potree-desktop-conversion.PNG" />
+<p>After the processing, the pointcloud is loaded in the viewer and the converted files are available in the previously defined output target directory.</p>
+<img alt="Potree Desktop Converted pointcloud visualisation" class="align-center" src="../_images/potree-desktop-output.PNG" />
 </section>
+</section>
+<hr class="docutils" />
 <section id="potree-converter">
 <h2>Potree Converter<a class="headerlink" href="#potree-converter" title="Permalink to this heading">¶</a></h2>
 <p>PotreeConverter generates an octree LOD structure for streaming and real-time rendering of massive point clouds. The results can be viewed in web browser with Potree.
@@ -86,14 +95,21 @@ <h3>Getting started<a class="headerlink" href="#id1" title="Permalink to this he
 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="o">.</span>\<span class="n">PotreeConverter</span><span class="o">.</span><span class="n">exe</span> <span class="n">pointcloud</span><span class="o">.</span><span class="n">las</span> <span class="o">-</span><span class="n">o</span> <span class="n">output</span> <span class="o">-</span><span class="n">p</span> <span class="n">index</span>
 </pre></div>
 </div>
-<hr class="docutils" />
 <p>Where:</p>
 <ul class="simple">
 <li><p><em>PotreeConverter.exe</em> specify the executable file for the convertion;</p></li>
 <li><p><em>pointcloud.las</em> select the point cloud (las or laz) to be converter. This format is valid in case the point cloud file is located in the same folder of the converter exe. Otherwise it is necessary to specify the complete path of the file;</p></li>
 <li><p><em>output</em> is the name of the directory where to save the converted point cloud. In this case too, if the target folder is outside the converter one, it is necessary to specify the entire path.</p></li>
 <li><p><em>index</em> is the default name to be given to the output file.</p></li>
 </ul>
+<p>After launching, the conversion is executed and details about each step of the the processing are reported on the cmd shell window.</p>
+<img alt="Potree Converter - Conversion details output" class="align-center" src="../_images/potree-converter-conversion-details.PNG" />
+<p>If successful, the conversion procedure gives as output a folder named as defined in the command (in this case <em>output</em>) containing 3 elements:</p>
+<ol class="arabic simple">
+<li><p>a folder named <strong>libs</strong> that contains all the required libraries and scripts to make Potree operative (e.g. <em>three.js</em>, <em>openlayers</em>…);</p></li>
+<li><p>a folder named <strong>pointclouds</strong> containing an <strong>index</strong> directory that collects that 4 files resulting from the conversion of the original pointclouds. The <em>metadata.json</em> is the file called in the Potree environment when loading the pointcloud to the scene;</p></li>
+<li><p>an html file called <strong>index.html</strong> that includes a basic structure for a web page with a Potree viewer.</p></li>
+</ol>
 </section>
 <section id="publications">
 <h3>Publications<a class="headerlink" href="#publications" title="Permalink to this heading">¶</a></h3>
@@ -103,6 +119,7 @@ <h3>Publications<a class="headerlink" href="#publications" title="Permalink to t
 </ul>
 </section>
 </section>
+<hr class="docutils" />
 <section id="potree-develop">
 <h2>Potree Develop<a class="headerlink" href="#potree-develop" title="Permalink to this heading">¶</a></h2>
 <p>to be written</p>