Metadata-Version: 2.2
Name: nanoprc-py
Version: 0.1.1
Summary: Python bindings for reading and writing PRC and PDF-embedded PRC data with nanoPRC
Author: nanoPRC contributors
License: AGPL-3.0-or-later
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: C++
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Operating System :: OS Independent
Project-URL: Homepage, https://github.com/mvrhel/nanoPRC
Project-URL: Repository, https://github.com/mvrhel/nanoPRC
Project-URL: Issues, https://github.com/mvrhel/nanoPRC/issues
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# nanoprc-py

Python bindings for nanoPRC, a library for reading and writing PRC and PDF embedded-PRC 3D data. For details see nanoprc.org. For commerical licensing see cascadiavoxel.com

This package provides:

- PRC/PDF open and parse APIs
- Model tree view inspection
- Tessellation and face-level geometry access
- PRC writing and optional PDF embedding

## Install

```bash
python -m pip install nanoprc-py
```

## Quick Start

```python
import nanoprc_py

ctx = nanoprc_py.Context()
doc = ctx.open("path/to/model.prc")
print("Opened:", doc.is_open)
print("Views:", doc.number_of_views)
```

## Included Examples

The source repository includes runnable examples under `python/examples/`:

- Open files and validate parser state
- Inspect model trees and tessellation summaries
- OpenGL viewer demo
- Attribute inspection
- Teapot write example (PRC and optional PDF)

## Optional Viewer Dependencies

For the OpenGL viewer example:

```bash
python -m pip install glfw PyOpenGL
```

## Supported Python Versions

- Python 3.9+

## License

AGPL-3.0-or-later.

## Links

- Source: https://github.com/mvrhel/nanoPRC
- Issues: https://github.com/mvrhel/nanoPRC/issues

## Maintainer and Development Docs

Local build/debug instructions, release automation, and packaging details are in `python/DEVELOPMENT.md` in the repository.
