Metadata-Version: 2.1
Name: ar-site-maker
Version: 1.0.1
Summary: A tool to create a website where 3D models can be viewed using AR technology.
Home-page: https://github.com/enfy-space/ArSiteMaker
Author: Taiyu Honma(ENFY)
Author-email: enfy.t.honma@gmail.com
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: qrcode
Requires-Dist: pymarker
Requires-Dist: Pillow
Requires-Dist: fire

# AR Site Maker
A tool to create a website where 3D models can be viewed using AR technology.
You can make simple marker based AR site that can view 3D model. 
Simply specify the site name, 3D model file (.glb), and marker image (URL).
You can try demo project by accessing below QR code and holding up QR code a camera after site is loaded.
You have to allow camera access from demo site.

<img src="sample_project/marker/marker_add_padding.png" width="400px">

## How to install
ar-site-maker is available through pip and [PyPi](https://pypi.org/project/ar-site-maker/). You need python3.
```
pip install ar-site-maker
```
You can confirm installation by executing ar-site-maker command.
```
ar-site-maker 
```
You can show top page like this if ar-site-maker is successfully installed.
```
Ar Site Maker {version}
 Documentation is here https://github.com/enfy-space/ArSiteMaker
```

## Usage
Usage is very easy!
<br>
### Preparing File
What you have to prepare is below.
* <b>.glb file</b>
  Sorry! we don't support .gltf file yet 🥹.
  <br>Please make sure to your model is

  * located around center of coordinate:(0,0,0)
  * not buried in plane (elevation=0)

* <b> marker image or site URL </b>
  <br>Generated site is marker-based AR so Object is appear on the marker.
  There are two-way to make marker. 
  
  * image : You can set your favorite image as marker. 
  We recommend as simple and square as image possible.
  * URL : If specify your site URL, ar-site-maker set QR-code as marker automatically.

### Command Usage
Basic usage of command is below. <br>
If you want to use your favorite image as marker
```
 ar-site-maker make <your project name> <glb file path> -i <image path>
```
If you want to use QR code of your site as marker
```
 ar-site-maker make <your project name> <glb file path> -u <url>
```
#### Options
* title

  The site title will be the same as the project name if not specified.
If you want to set title arbitrarily, you can use --site_title option like this.
  ```
  ar-site-maker make <your project name> <glb file path> -u <url> --site_title <title>
  ```

* scale

  If you want to adjust object scale, you can use --scale option like this.
  ```
  ar-site-maker make <your project name> <glb file path> -u <url> --scale <scale>
  ```
* animation

  If you want to add rotate animation to object, you can add -a (or --animation) option like this.
  ```
  ar-site-maker make <your project name> <glb file path> -u <url> -a 
  ```

of course! you can open help like this
```
  ar-site-maker make -h 
```

#### Output
Your exported data is in directory named fot the project.
You can browse exported site by accessing index.html. The marker is stored in marker directory.
You can use marker.png or marker_add_padding.png ; marker added padding as marker. 
```
project name
├── index.html
├── marker
│   ├── marker.patt
│   ├── marker.png
│   └── marker_add_padding.png
└── model
    └── model.glb
```
