"A real world environment to place, view, and share all your 3D models."
View Live App »
Table of Contents
3D Model World allows users to upload their own 3D models (photogrammetry or otherwise created) into a real-world environment using a map API. The user can then name, move, re-size, and rotate their models to their liking. Once a user has a map instance created, they can then share their URL with others to show off all their work and models.
There have been a lot of attempts to build something similar like this. (See for example Sketchfab's experiment and Polycam's map).
Our team thought it would be nice to expand on these great ideas and merge the 2D maps and 3D objects together. Doing this will let the user show the 3D objects embedded directly on a single interactable map. The great benefit here is that all objects can now be compared and viewed in a single environment. This also provides a true appreciation of scale.
Besides just the prior attempts to make something like this there is a huge community of people scanning 3D objects, (see the hashtags #objectcapture or #1scanaday on Twitter). As of right now these people don't have an efficient way to show off all their scans in a single environment; 3D Model World fixed that.
Make sure you have at least npm: 7.#.# and node: 14.#.#
- Clone the repo
git clone https://github.com/codeLabs-summer2021/3D-Model-World.git
- Install NPM packages
npm install
- Run the app
npm start
To use the app, follow these simple steps:
- Make sure you have a Sketchfab account. (Completely free to create).
- Click the Menu button.
- Click
Login to Sketchfab. - Once you authorize the app to connect to your Sketchfab account you can now use the app.
Loading models is as simple as copy/paste. Just click on the Menu button and navigate to the Add Model section. Now simply copy the Sketchfab URL of the desired model and paste it in the ‘URL’ box. Fill out the rest of the information about the model and click ‘Add’. The App will let you know the loading progress and whether it was successful or not. From here you can display your model or load another.
All existing models in your map will be shown in the Model List in the Menu. This list will make it easy to locate and delete your models.
Moving a model is as easy as right-clicking.
Terrain is active so you can see your models compared to the real world environments.
Building toggle is also an option for those who are curious how a model fairs compared to real buildings.
Type in a location and see the camera move smoothly to the destination.
Got turned upside down? Simply reorient yourself with the compass button.
See the open issues for a list of proposed features (and known issues).
Any contributions are greatly appreciated. Please feel free to add any features or fixes you like. We will review the PR and be happy to add your work to this project.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/NewFeature) - Commit your Changes (
git commit -m 'Add some NewFeature') - Push to the Branch (
git push origin feature/NewFeature) - Open a Pull Request
This app's creation started during the 2021 summer CodeDay Labs. It was created by Caleb McOlin and Rodrigo Andrade with Omar Shehata as the mentor.
- Saturn V and Falcon 9 by Stanley_Creative