Metadata-Version: 2.1
Name: pyCloudCompareCLI
Version: 0.2
Summary:  Python Wrapper for CloudCompare CLI 
Home-page: https://github.com/dwoiwode/pyCloudCompareCLI
Author: dwoiwode
Author-email: 
License: MIT
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# CloudCompare CLI Python Wrapper
This is a python wrapper for CloudCompare CLI based on this [Wiki Page](https://www.cloudcompare.org/doc/wiki/index.php?title=Command_line_mode).

You can build and chain commands which can be executed. 

## Requirements
* Python3.6+
* An installed version of [CloudCompare](https://cloudcompare.org/)

## Basic Usage
Read ply-file and save in ascii-format with extension ".xyz".

````python
import pyCloudCompare as cc

cli = cc.CloudCompareCLI()
cmd = cli.new_command()
cmd.silent()  # Disable console
cmd.open("pointcloud.ply")  # Read file
cmd.cloud_export_format(cc.CLOUD_EXPORT_FORMAT.ASCII, extension="xyz")
cmd.save_clouds("newPointcloud.xyz")
print(cmd)
cmd.execute()
````

Same example with Context-Manager:

````python
import pyCloudCompare as cc

cli = cc.CloudCompareCLI()
with cli.new_command() as cmd:
    cmd.silent()  # Disable console
    cmd.open("pointcloud.ply")  # Read file
    cmd.cloud_export_format(cc.CLOUD_EXPORT_FORMAT.ASCII, extension="xyz")
    cmd.save_clouds("newPointcloud.xyz")
    print(cmd)
````

## Acknowledgements
The work in the scope of the CloudCompare CLI Python Wrapper in this repository is supported by the [Institute of Geo-Engineering at Clausthal University of Technology](https://www.ige.tu-clausthal.de).


