https://github.com/autodesk-forge/reality.capture-nodejs-photo.to.3d

Photo to 3d: Creates 3d models from photos using Node.js
https://github.com/autodesk-forge/reality.capture-nodejs-photo.to.3d

nodejs reality-capture

Last synced: about 5 hours ago
JSON representation

Photo to 3d: Creates 3d models from photos using Node.js

• Host: GitHub
• URL: https://github.com/autodesk-forge/reality.capture-nodejs-photo.to.3d
• Owner: Autodesk-Forge
• License: mit
• Created: 2017-11-09T03:04:59.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2022-12-13T14:46:18.000Z (almost 2 years ago)
• Last Synced: 2024-04-09T21:50:13.855Z (7 months ago)
• Topics: nodejs, reality-capture
• Language: HTML
• Homepage:
• Size: 1.67 MB
• Stars: 66
• Watchers: 16
• Forks: 24
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Photo to 3D (photogrammetry) sample

![Platforms](https://img.shields.io/badge/platform-windows%20%7C%20osx%20%7C%20linux-lightgray.svg)

[![Node.js](https://img.shields.io/badge/Node.js-4.4.3-blue.svg)](https://nodejs.org/)

[![npm](https://img.shields.io/badge/npm-2.15.1-blue.svg)](https://www.npmjs.com/)

[![License](http://img.shields.io/:license-mit-blue.svg)](http://opensource.org/licenses/MIT)

**Forge API:** [![oAuth2](https://img.shields.io/badge/oAuth2-v2-green.svg)](http://developer-autodesk.github.io/)

[![Reality-Capture](https://img.shields.io/badge/Reality%20Capture-v1-green.svg)](http://developer-autodesk.github.io/)

![Basic](https://img.shields.io/badge/Level-Basic-green.svg)

# Description

This sample illustrates the [Forge Reality Capture API](https://developer.autodesk.com/api/reality-capture-cover-page/)'s photogrammetry workflow:

- Create a photo scene

- Add photos to a scene

- Generate a 3D mesh model

- Obtain a download link for the model

### Thumbnail

![thumbnail](./screen.png)

# Setup

## Prerequisites

1. **Forge Account**: Learn how to create a Forge Account, activate subscription and create an app at [this tutorial](http://learnforge.autodesk.io/#/account/);

2. [Node.Js](https://nodejs.org) and basic knowledge of JavaScript;

3. [Visual Studio Code](https://code.visualstudio.com/) or any other code editor.

For using this sample, you need an Autodesk developer credentials. Visit the [Forge Developer Portal](https://developer.autodesk.com), sign up for an account, then [create an app](https://developer.autodesk.com/myapps/create). For this new app, use `https://localhost:3000/api/forge/callback/oauth` as Callback URL. Finally take note of the **Client ID** and **Client Secret**. 

##Running locally

For localhost testing:

- FORGE\_CLIENT\_ID and set it to above-mentioned **Client ID**

- FORGE\_CLIENT\_SECRET and set it to above-mentioned **Client Secret**

- FORGE\_CALLBACK\_URL and set it to `https://localhost:3000/api/forge/callback/oauth`

1. Clone this project or download it. It's recommended to install [GitHub desktop](https://desktop.github.com/). To clone it via command line, use the following (**Terminal** on MacOSX/Linux, **Git Shell** on Windows):

    	git clone https://github.com/Autodesk-Forge/reality.capture-nodejs-photo.to.3d.git

2. Using the command line, go into newly created `reality.capture-nodejs-photo.to.3d` folder (make sure sure that the current directory contains `package.json`) and type:

		npm install

	

	to install all the dependencies.

3. Using the command line, type  

		node index.js

	to start the local server

	

4. Open a browser and navigate to: 

		

		http://localhost:3000

## Deployment

To deploy this application to Heroku, the **Callback URL** for Forge must use your `.herokuapp.com` address. After clicking on the button below, at the Heroku Create New App page, set your Client ID, Secret and Callback URL for Forge.

[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)

Watch [this video](https://www.youtube.com/watch?v=Oqa9O20Gj0c) on how deploy samples to [Heroku](https://heroku.com).

# Further Reading

Documentation:

- [OAuth API](https://forge.autodesk.com/en/docs/oauth/v2/)

- [Reality Capture API](https://forge.autodesk.com/en/docs/reality-capture/v1)

Tutorials:

- [Create 3D Mesh from Photos](https://forge.autodesk.com/en/docs/reality-capture/v1/tutorials/create-3d-mesh-from-photos/)

Blogs:

- [Forge Blog](https://forge.autodesk.com/blog/hitchhikers-guide-reality-capture-api)

Other samples:

- [reality.capture-go-photoII3D

](https://github.com/apprentice3d/reality.capture-go-photoII3D)

- [reality.capture-go-cli

](https://github.com/apprentice3d/reality.capture-go-cli)

# License

This sample is licensed under the terms of the [MIT License](http://opensource.org/licenses/MIT). Please see the [LICENSE](LICENSE) file for full details.

# Written by

Eugene Chua [[email protected]]([email protected])

## Updated By

- [September 2018]: Denis Grigor [[email protected]]([email protected]), [Forge Partner Development](http://forge.autodesk.com)