diff --git a/docs/_build/doctrees/environment.pickle b/docs/_build/doctrees/environment.pickle index fe5df71..8da04ec 100644 Binary files a/docs/_build/doctrees/environment.pickle and b/docs/_build/doctrees/environment.pickle differ diff --git a/docs/_build/doctrees/pages/potree.doctree b/docs/_build/doctrees/pages/potree.doctree index 939e271..ba44e2b 100644 Binary files a/docs/_build/doctrees/pages/potree.doctree and b/docs/_build/doctrees/pages/potree.doctree differ diff --git a/docs/_build/html/_images/potree-converter-conversion-details.PNG b/docs/_build/html/_images/potree-converter-conversion-details.PNG new file mode 100644 index 0000000..309da85 Binary files /dev/null and b/docs/_build/html/_images/potree-converter-conversion-details.PNG differ diff --git a/docs/_build/html/_images/potree-desktop-conversion.PNG b/docs/_build/html/_images/potree-desktop-conversion.PNG new file mode 100644 index 0000000..feda66e Binary files /dev/null and b/docs/_build/html/_images/potree-desktop-conversion.PNG differ diff --git a/docs/_build/html/_images/potree-desktop-output.PNG b/docs/_build/html/_images/potree-desktop-output.PNG new file mode 100644 index 0000000..db8c311 Binary files /dev/null and b/docs/_build/html/_images/potree-desktop-output.PNG differ diff --git a/docs/_build/html/_sources/pages/potree.rst.txt b/docs/_build/html/_sources/pages/potree.rst.txt index 0cb847c..c8de197 100644 --- a/docs/_build/html/_sources/pages/potree.rst.txt +++ b/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,8 +98,6 @@ 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; @@ -89,6 +105,17 @@ Where: * *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 ++++++++++++ @@ -96,6 +123,8 @@ Publications * `Potree: Rendering Large Point Clouds in Web Browsers. `__ * `Fast Out-of-Core Octree Generation for Massive Point Clouds `__, Schütz M., Ohrhallinger S., Wimmer M. +""""""""""""""""""""""""""""""""""""""""""""""" + Potree Develop -------------- diff --git a/docs/_build/html/pages/potree.html b/docs/_build/html/pages/potree.html index 4d0085d..9cb894f 100644 --- a/docs/_build/html/pages/potree.html +++ b/docs/_build/html/pages/potree.html @@ -64,9 +64,18 @@

Graphic User Interface

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.

    +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.

    +Potree Desktop Converted pointcloud visualisation
    + +

    Potree Converter

    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,7 +95,6 @@

    Getting started
    .\PotreeConverter.exe pointcloud.las -o output -p index
    -

    Where:

    Publications

    @@ -103,6 +119,7 @@

    Publications

    Potree Develop

    to be written

    diff --git a/docs/_build/html/searchindex.js b/docs/_build/html/searchindex.js index 433c02a..b3c78f8 100644 --- a/docs/_build/html/searchindex.js +++ b/docs/_build/html/searchindex.js @@ -1 +1 @@ -Search.setIndex({"docnames": ["index", "pages/getting-started", "pages/intro", "pages/potree"], "filenames": ["index.rst", "pages\\getting-started.rst", "pages\\intro.rst", "pages\\potree.rst"], "titles": ["Welcome to potree-templates\u2019s documentation!", "Getting started with potree-templates", "Introduzione", "Potree"], "terms": {"introduzion": 0, "credit": 0, "scopo": 0, "glossario": 0, "get": 0, "start": 0, "index": [0, 3], "modul": 0, "search": 0, "page": [0, 2], "thi": [1, 2, 3], "cover": 1, "how": 1, "creat": 1, "simpl": 1, "navig": [1, 3], "point": [1, 3], "cloud": [1, 3], "environ": [1, 3], "exampl": [2, 3], "anchor": 2, "section": 2, "text": 2, "goe": 2, "here": 2, "bold": 2, "ital": 2, "superscript": 2, "subscript": 2, "note": 2, "box": 2, "seealso": 2, "warn": 2, "hint": 2, "html": 2, "ifram": 2, "download": [2, 3], "file": [2, 3], "must": 2, "repositori": 2, "folder": [2, 3], "png": 2, "i": [2, 3], "link": [2, 3], "web": [2, 3], "http": [2, 3], "labmgf": 2, "dica": 2, "polimi": 2, "b": 2, "href": 2, "code": [2, 3], "block": 2, "bullet": 2, "list": 2, "item": 2, "1": 2, "2": [2, 3], "3": [2, 3], "etc": 2, "auto": 2, "enumer": 2, "desktop": 0, "convert": 0, "develop": 0, "free": 3, "open": 3, "sourc": 3, "webgl": 3, "base": 3, "render": 3, "larg": 3, "institut": 3, "comput": 3, "graphic": [], "algorithm": 3, "tu": 3, "wien": 3, "austria": 3, "There": 3, "ar": 3, "wai": 3, "access": 3, "version": 3, "allow": 3, "drag": 3, "drop": 3, "viewer": 3, "github": 3, "com": 3, "potreedesktop": 3, "releas": 3, "your": 3, "format": 3, "potreeconvert": 3, "edit": 3, "sever": 3, "written": 3, "A": 3, "portabl": 3, "thank": 3, "electron": 3, "you": 3, "load": 3, "from": 3, "hard": 3, "disk": 3, "extern": 3, "drive": 3, "It": 3, "": 3, "also": 3, "so": 3, "can": 3, "put": 3, "model": 3, "togeth": 3, "usb": 3, "wherev": 3, "go": 3, "onli": 3, "been": 3, "test": 3, "window": 3, "moment": 3, "mai": 3, "work": 3, "other": 3, "system": 3, "abl": 3, "us": 3, "same": 3, "oper": 3, "ve": 3, "initi": 3, "built": 3, "j": 3, "add": 3, "scene": 3, "zip": 3, "onc": 3, "instal": 3, "extract": 3, "all": 3, "execut": 3, "bat": 3, "Then": 3, "new": 3, "appear": 3, "main": 3, "user": [], "interfac": [], "The": 3, "gui": 3, "made": 3, "compon": 3, "sidebar": 3, "left": 3, "includ": 3, "featur": 3, "tool": 3, "elabor": 3, "right": 3, "actual": 3, "space": 3, "visual": 3, "explor": 3, "under": 3, "construct": 3, "gener": 3, "an": 3, "octre": 3, "lod": 3, "structur": 3, "stream": 3, "real": 3, "time": 3, "massiv": 3, "result": 3, "view": 3, "browser": 3, "convers": 3, "produc": 3, "total": 3, "better": 3, "support": 3, "standard": 3, "la": 3, "attribut": 3, "arbitrari": 3, "extra": 3, "windwo": 3, "Be": 3, "sure": 3, "ex": 3, "present": 3, "insid": 3, "unzip": 3, "For": 3, "make": 3, "easier": 3, "process": 3, "suggest": 3, "copi": 3, "past": 3, "pointcloud": 3, "laz": 3, "fast": 3, "out": 3, "core": 3, "sch\u00fctz": 3, "m": 3, "ohrhalling": 3, "wimmer": 3, "write": 3, "cmd": 3, "address": 3, "bar": 3, "press": 3, "enter": 3, "shell": 3, "have": 3, "referenc": 3, "directori": 3, "In": 3, "order": 3, "trigger": 3, "modifi": 3, "follow": 3, "accord": 3, "need": 3, "o": 3, "output": 3, "p": 3, "where": 3, "specifi": 3, "select": 3, "valid": 3, "case": 3, "locat": 3, "otherwis": 3, "necessari": 3, "complet": 3, "path": 3, "name": 3, "save": 3, "too": 3, "target": 3, "outsid": 3, "one": 3, "entir": 3, "default": 3, "given": 3}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"welcom": 0, "potre": [0, 1, 3], "templat": [0, 1], "": 0, "document": 0, "content": 0, "indic": 0, "tabl": 0, "get": [1, 3], "start": [1, 3], "introduzion": 2, "credit": 2, "subsect": 2, "scopo": 2, "glossario": 2, "desktop": 3, "convert": 3, "develop": 3, "graphic": 3, "user": 3, "interfac": 3, "public": 3}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 57}, "alltitles": {"Getting started with potree-templates": [[1, "getting-started-with-potree-templates"]], "Introduzione": [[2, "introduzione"]], "Credits": [[2, "credits"]], "Subsection": [[2, "subsection"]], "Scopo": [[2, "scopo"]], "Glossario": [[2, "glossario"]], "Welcome to potree-templates\u2019s documentation!": [[0, "welcome-to-potree-templates-s-documentation"]], "Contents:": [[0, null]], "Indices and tables": [[0, "indices-and-tables"]], "Potree": [[3, "potree"]], "Potree Desktop": [[3, "potree-desktop"]], "Getting started": [[3, "getting-started"], [3, "id1"]], "Graphic User Interface": [[3, "graphic-user-interface"]], "Potree Converter": [[3, "potree-converter"]], "Publications": [[3, "publications"]], "Potree Develop": [[3, "potree-develop"]]}, "indexentries": {}}) \ No newline at end of file +Search.setIndex({"docnames": ["index", "pages/getting-started", "pages/intro", "pages/potree"], "filenames": ["index.rst", "pages\\getting-started.rst", "pages\\intro.rst", "pages\\potree.rst"], "titles": ["Welcome to potree-templates\u2019s documentation!", "Getting started with potree-templates", "Introduzione", "Potree"], "terms": {"introduzion": 0, "credit": 0, "scopo": 0, "glossario": 0, "get": 0, "start": 0, "index": [0, 3], "modul": 0, "search": 0, "page": [0, 2, 3], "thi": [1, 2, 3], "cover": 1, "how": 1, "creat": 1, "simpl": 1, "navig": [1, 3], "point": [1, 3], "cloud": [1, 3], "environ": [1, 3], "exampl": [2, 3], "anchor": 2, "section": 2, "text": 2, "goe": 2, "here": 2, "bold": 2, "ital": 2, "superscript": 2, "subscript": 2, "note": 2, "box": 2, "seealso": 2, "warn": 2, "hint": 2, "html": [2, 3], "ifram": 2, "download": [2, 3], "file": [2, 3], "must": 2, "repositori": 2, "folder": [2, 3], "png": 2, "i": [2, 3], "link": [2, 3], "web": [2, 3], "http": [2, 3], "labmgf": 2, "dica": 2, "polimi": 2, "b": 2, "href": 2, "code": [2, 3], "block": 2, "bullet": 2, "list": 2, "item": 2, "1": 2, "2": [2, 3], "3": [2, 3], "etc": 2, "auto": 2, "enumer": 2, "desktop": 0, "convert": 0, "develop": 0, "free": 3, "open": 3, "sourc": 3, "webgl": 3, "base": 3, "render": 3, "larg": 3, "institut": 3, "comput": 3, "graphic": [], "algorithm": 3, "tu": 3, "wien": 3, "austria": 3, "There": 3, "ar": 3, "wai": 3, "access": 3, "version": 3, "allow": 3, "drag": 3, "drop": 3, "viewer": 3, "github": 3, "com": 3, "potreedesktop": 3, "releas": 3, "your": 3, "format": 3, "potreeconvert": 3, "edit": 3, "sever": 3, "written": 3, "A": 3, "portabl": 3, "thank": 3, "electron": 3, "you": 3, "load": 3, "from": 3, "hard": 3, "disk": 3, "extern": 3, "drive": 3, "It": 3, "": 3, "also": 3, "so": 3, "can": 3, "put": 3, "model": 3, "togeth": 3, "usb": 3, "wherev": 3, "go": 3, "onli": 3, "been": 3, "test": 3, "window": 3, "moment": 3, "mai": 3, "work": 3, "other": 3, "system": 3, "abl": 3, "us": 3, "same": 3, "oper": 3, "ve": 3, "initi": 3, "built": 3, "j": 3, "add": 3, "scene": 3, "zip": 3, "onc": 3, "instal": 3, "extract": 3, "all": 3, "execut": 3, "bat": 3, "Then": 3, "new": 3, "appear": 3, "main": 3, "user": [], "interfac": [], "The": 3, "gui": 3, "made": 3, "compon": 3, "sidebar": 3, "left": 3, "includ": 3, "featur": 3, "tool": 3, "elabor": 3, "right": 3, "actual": 3, "space": 3, "visual": 3, "explor": 3, "under": [], "construct": [], "gener": 3, "an": 3, "octre": 3, "lod": 3, "structur": 3, "stream": 3, "real": 3, "time": 3, "massiv": 3, "result": 3, "view": 3, "browser": 3, "convers": [], "produc": 3, "total": 3, "better": 3, "support": 3, "standard": 3, "la": 3, "attribut": 3, "arbitrari": 3, "extra": 3, "windwo": 3, "Be": 3, "sure": 3, "ex": 3, "present": 3, "insid": 3, "unzip": 3, "For": 3, "make": 3, "easier": 3, "process": 3, "suggest": 3, "copi": 3, "past": 3, "pointcloud": [], "laz": 3, "fast": 3, "out": 3, "core": 3, "sch\u00fctz": 3, "m": 3, "ohrhalling": 3, "wimmer": 3, "write": 3, "cmd": 3, "address": 3, "bar": 3, "press": 3, "enter": 3, "shell": 3, "have": 3, "referenc": 3, "directori": 3, "In": 3, "order": 3, "trigger": 3, "modifi": 3, "follow": 3, "accord": 3, "need": 3, "o": 3, "output": 3, "p": 3, "where": 3, "specifi": 3, "select": 3, "valid": 3, "case": 3, "locat": 3, "otherwis": 3, "necessari": 3, "complet": 3, "path": 3, "name": 3, "save": 3, "too": 3, "target": 3, "outsid": 3, "one": 3, "entir": 3, "default": 3, "given": 3, "provid": 3, "friendli": 3, "compat": 3, "do": 3, "simpli": 3, "desir": 3, "poincloud": 3, "after": 3, "check": 3, "input": 3, "defin": 3, "requir": 3, "adopt": 3, "0": 3, "instead": 3, "thousand": 3, "million": 3, "click": 3, "button": 3, "continu": 3, "avail": 3, "previous": 3, "launch": 3, "detail": 3, "about": 3, "each": 3, "step": 3, "report": 3, "If": 3, "success": 3, "procedur": 3, "give": 3, "command": 3, "contain": 3, "element": 3, "lib": 3, "librari": 3, "script": 3, "e": 3, "g": 3, "three": 3, "openlay": 3, "collect": 3, "4": 3, "origin": 3, "metadata": 3, "json": 3, "call": 3, "when": 3, "basic": 3}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"welcom": 0, "potre": [0, 1, 3], "templat": [0, 1], "": 0, "document": 0, "content": 0, "indic": 0, "tabl": 0, "get": [1, 3], "start": [1, 3], "introduzion": 2, "credit": 2, "subsect": 2, "scopo": 2, "glossario": 2, "desktop": 3, "convert": 3, "develop": 3, "graphic": 3, "user": 3, "interfac": 3, "public": 3, "pointcloud": 3, "convers": 3}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 57}, "alltitles": {"Getting started with potree-templates": [[1, "getting-started-with-potree-templates"]], "Introduzione": [[2, "introduzione"]], "Credits": [[2, "credits"]], "Subsection": [[2, "subsection"]], "Scopo": [[2, "scopo"]], "Glossario": [[2, "glossario"]], "Welcome to potree-templates\u2019s documentation!": [[0, "welcome-to-potree-templates-s-documentation"]], "Contents:": [[0, null]], "Indices and tables": [[0, "indices-and-tables"]], "Potree": [[3, "potree"]], "Potree Desktop": [[3, "potree-desktop"]], "Getting started": [[3, "getting-started"], [3, "id1"]], "Graphic User Interface": [[3, "graphic-user-interface"]], "Pointcloud conversion": [[3, "pointcloud-conversion"]], "Potree Converter": [[3, "potree-converter"]], "Publications": [[3, "publications"]], "Potree Develop": [[3, "potree-develop"]]}, "indexentries": {}}) \ No newline at end of file diff --git a/docs/pages/img/potree-converter-conversion-details.PNG b/docs/pages/img/potree-converter-conversion-details.PNG new file mode 100644 index 0000000..309da85 Binary files /dev/null and b/docs/pages/img/potree-converter-conversion-details.PNG differ diff --git a/docs/pages/img/potree-desktop-conversion.PNG b/docs/pages/img/potree-desktop-conversion.PNG new file mode 100644 index 0000000..feda66e Binary files /dev/null and b/docs/pages/img/potree-desktop-conversion.PNG differ diff --git a/docs/pages/img/potree-desktop-output.PNG b/docs/pages/img/potree-desktop-output.PNG new file mode 100644 index 0000000..db8c311 Binary files /dev/null and b/docs/pages/img/potree-desktop-output.PNG differ diff --git a/docs/pages/potree.rst b/docs/pages/potree.rst index 0cb847c..c8de197 100644 --- a/docs/pages/potree.rst +++ b/docs/pages/potree.rst @@ -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,8 +98,6 @@ 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; @@ -89,6 +105,17 @@ Where: * *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 ++++++++++++ @@ -96,6 +123,8 @@ Publications * `Potree: Rendering Large Point Clouds in Web Browsers. `__ * `Fast Out-of-Core Octree Generation for Massive Point Clouds `__, Schütz M., Ohrhallinger S., Wimmer M. +""""""""""""""""""""""""""""""""""""""""""""""" + Potree Develop --------------