Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
addressed some comments and added docs
- Loading branch information
1 parent
8551fa7
commit 77771e2
Showing
5 changed files
with
114 additions
and
12 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,31 @@ | ||
.. _readers.draco: | ||
|
||
readers.draco | ||
============= | ||
|
||
`Draco`_ is a library for compressing and decompressing 3D geometric meshes and | ||
point clouds and was designed and built for compression efficiency and speed. | ||
The code supports compressing points, connectivity information, texture coordinates, | ||
color information, normals, and any other generic attributes associated with geometry. | ||
|
||
Example | ||
-------------------------------------------------------------------------------- | ||
|
||
.. code-block:: json | ||
[ | ||
{ | ||
"type": "readers.draco", | ||
"filename": "color.las" | ||
} | ||
] | ||
|
||
Options | ||
------- | ||
|
||
filename | ||
Input file name. [Required] | ||
|
||
.. include:: reader_opts.rst | ||
|
||
.. _Draco: https://github.com/google/draco |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,70 @@ | ||
.. _writers.draco: | ||
|
||
writers.draco | ||
============= | ||
|
||
`Draco`_ is a library for compressing and decompressing 3D geometric meshes and | ||
point clouds and was designed and built for compression efficiency and speed. | ||
The code supports compressing points, connectivity information, texture coordinates, | ||
color information, normals, and any other generic attributes associated with geometry. | ||
|
||
This writer aims to use the encoding feature of the Draco library to compress and | ||
output Draco files. | ||
|
||
Example | ||
-------------------------------------------------------------------------------- | ||
|
||
This example will read in a las file and output a Draco encoded file, with options | ||
to include PDAL dimensions X, Y, and Z as double, and explicitly setting quantization | ||
levels of some of the Draco attributes. | ||
|
||
.. code-block:: json | ||
[ | ||
{ | ||
"type": "readers.las", | ||
"filename": "color.las" | ||
}, | ||
{ | ||
"type": "writers.draco", | ||
"filename": "draco.drc", | ||
"dimensions": { | ||
"X": "double", | ||
"Y": "double", | ||
"Z": "double" | ||
}, | ||
"quantization": { | ||
"NORMAL": 8, | ||
"TEX_COORD": 7, | ||
"GENERIC": 6 | ||
} | ||
} | ||
] | ||
|
||
Options | ||
------- | ||
|
||
filename | ||
Output file name. [Required] | ||
|
||
dimensions | ||
A json map of PDAL dimensions to desired data types. Data types must be string | ||
and must be available in `PDAL's Type specification`_. | ||
|
||
quantization | ||
A json map of Draco attributes to desired quantization levels. These levels | ||
must be integers. Default quantization levels are below, and will be | ||
overridden by any values placed in the options. | ||
|
||
..code-block:: json | ||
{ | ||
"POSITION": 11, | ||
"NORMAL": 7, | ||
"TEX_COORD": 10, | ||
"COLOR": 8, | ||
"GENERIC": 8 | ||
} | ||
|
||
|
||
|
||
_PDAL's Type specification: https://github.com/PDAL/PDAL/blob/master/pdal/DimUtil.hpp |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters