Metadata-Version: 2.1
Name: viewscad
Version: 0.2.0
Summary: Jupyter renderer for the OpenSCAD & SolidPython constructive solid geometry systems
Home-page: https://github.com/nickc92/ViewSCAD
Author: Nick Choly
Author-email: nickcholy@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Other Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Mathematics
Description-Content-Type: text/markdown
Requires-Dist: jupyter
Requires-Dist: jupyterlab
Requires-Dist: ipywidgets
Requires-Dist: pythreejs
Requires-Dist: solidpython

# ViewSCAD: CAD in Jupyter

ViewSCAD is a module that renders within a Jupyter notebook 3D objects described in the [OpenSCAD](https://openscad.org) language, or described using the [SolidPython](https://github.com/SolidCode/SolidPython) module.  It provides a workflow for CAD design completely within the Jupyter notebook.

## Installation
ViewSCAD utilizes the `openscad` executable to render objects, and as such, OpenSCAD must be installed on your system.  

ViewSCAD installs simply with pip:
```
pip install viewscad
```
ViewSCAD uses the `pythreejs` notebook extension to render the 3D graphics.
If you intend to use `jupyter notebook`, you should be all set.  However, if you intend to use `jupyter lab`,  additional steps are necessary to get `pythreejs` working in the lab.  Firstly, you must install [node.js and npm](https://nodejs.org/en/download/).  Then you must install the lab extensions:
```
jupyter labextension install @jupyter-widgets/jupyterlab-manager
```

## Setup and Usage

See the [OpenSCAD](https://openscad.org) and [SolidPython](https://github.com/SolidCode/SolidPython) pages for how to use these languages to represent geometric objects.

The following shows how to use ViewSCAD to render a SolidPython object in Jupyter:
![solidpython example](https://github.com/nickc92/ViewSCAD/blob/master/images/solidpython_example.png)

ViewSCAD attempts to locate your openscad executable, based on your platform, but failing that, you can set the `OPENSCAD_EXEC` environment variable to point at your `openscad` command-line executable, or pass it in the constructor of the renderer:
```
renderer = viewscad.Renderer(openscad_exec='path_of_my_openscad')
```

You can also render OpenSCAD code:
![openscad example](images/openscad_example.png)

The renderer can also create an `.STL` file directly by simply adding an `outfile` keyword:
```
r.render(c, outfile='my_thing.stl')
```

### Intropection

By double-clicking on a rendered object, you can select faces, edges, and vertices, and learn their indices.  This allows you
to use several useful utilities, like `Renderer.rotate_face_down()` put orient the object with a particular face downward,
or `Renderer.place_on()`, which lets you place one object upon another:
![introspection example](https://github.com/nickc92/ViewSCAD/blob/master/images/introspection_example.png)

## Acknowledgements

Thanks to Evan Jones for help creating the PyPI package.


