Skip to content

Commit

Permalink
Update readme (#7)
Browse files Browse the repository at this point in the history
* Update readme

* Update readme
  • Loading branch information
gjmooney authored May 30, 2024
1 parent ce1013d commit a811bb4
Show file tree
Hide file tree
Showing 7 changed files with 28 additions and 0 deletions.
28 changes: 28 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,8 @@ A JupyterCAD plugin for the JupyterLab-Gather extenstion
## Requirements

- JupyterLab >= 4.0.0
- JupyterCAD >= 2.0.0a6
- JupyterLab-Gather >= 0.1.0

## Install

Expand All @@ -16,6 +18,32 @@ To install the extension, execute:
pip install jupytercad_gather
```

## Usage

1. In the JupyterCAD UI, you'll see a new icon on the toolbar. Go ahead and give that a click.

![cad model](./docs/images/1_cadmodel.png 'CAD Model')

2. That'll open a new dialog where you can register the model with JupyterLab-Gather, enter the name of the object you want to register and click submit.

![dialog](./docs/images/2_dialog.png 'Dialog')

3. In the left hand sidebar of JupyterLab-Gather, you'll see a list of available models, including the one you just registered, select the model you just added and click the button to set the model.

![sidebar](./docs/images/3_sidebar.png 'Sidebar')

4. This loads the model from JupyterCAD in JupyterLab-Gather. You can manipulate the model using the JupyterCAD interface and the changes will be rendered on the AR model.

![update](./docs/images/4_update.png 'Update')

5. If you'd like to load the entire JupyterCAD scene into JupyterLab-Gather, simply enter `Scene` (or `scene`) as the name of the object when registering.

![register scene](./docs/images/5_scene.png 'Register Scene')

6. Load the scene just like you did for the object.

![loaded scene](./docs/images/6_loaded_scene.png 'Loaded Scene')

## Uninstall

To remove the extension, execute:
Expand Down
Binary file added docs/images/1_cadmodel.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/2_dialog.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/3_sidebar.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/4_update.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/5_scene.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/6_loaded_scene.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit a811bb4

Please sign in to comment.