Skip to content

Commit 51e5142

Browse files
committed
Add readme.
1 parent 55c549a commit 51e5142

File tree

2 files changed

+61
-0
lines changed

2 files changed

+61
-0
lines changed

Third Party Notices.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
This package contains third-party software components governed by the license(s) indicated below:
2+
---------
3+
4+
Component Name: monocular-depth-unity
5+
6+
License Type: MIT License
7+
8+
Copyright (c) 2021 GeorgeAdamon
9+
10+
Permission is hereby granted, free of charge, to any person obtaining a copy
11+
of this software and associated documentation files (the "Software"), to deal
12+
in the Software without restriction, including without limitation the rights
13+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
14+
copies of the Software, and to permit persons to whom the Software is
15+
furnished to do so, subject to the following conditions:
16+
17+
The above copyright notice and this permission notice shall be included in all
18+
copies or substantial portions of the Software.
19+
20+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
21+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
23+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
24+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
25+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
26+
SOFTWARE.

readme.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# Genesis
2+
3+
Experimental package that auto-generates depth textures for skyboxes created with [Skybox Lab](https://skybox.blockadelabs.com/).
4+
5+
## Disclaimer
6+
As of right now, this project's main purpose is experimentation. Feel free to try it out, but expect things to break.
7+
You're welcome to provide feedback here on GitHub or [Twitter](https://twitter.com/julien_kaye) or join the discussion on the [BlockadeLabs Discord](https://discord.gg/kqKB3X4TJz)
8+
9+
## Requirements
10+
This package was created with Unity 2021.3
11+
12+
## Installation
13+
Go to the release section, download the Unity Package and import it into any Unity project.
14+
The package is a 'Hybrid Package', so it will install into your Packages folder as a local package.
15+
16+
## Usage
17+
- Go to https://skybox.blockadelabs.com/ to generate a new panorama.
18+
- Use the menu *Genesis -> Import from Skybox Lab via ID*, enter the ID and hit *Import*
19+
20+
## Ideas
21+
Not a roadmap, just some general thoughts and ideas I have for the future.
22+
23+
- A next step could be to segment panoramas into layers using the generated depth. I'd like to experiment with sending a masked panorama back to SkyBox Labs as an input image for a new generation with the same prompt and automatically build a layered depth panorama that way. The idea here is that these are not real images, so we can let the AI hallucinate details where usually complex inpainting methods would be needed.
24+
- Another interesting experiment could be done with rendering the scene from a different viewpoint using the naively extruded sphere and then again use that as an input image for a new generation to continually build out a larger 3D world from a given prompt.
25+
- Add some export formats like .obj and glTF
26+
- The seams and depth discontinuities could probably be fixed in a quick-and-dirty way, but I'd rather wait until I've figured out a better way to do the depth estimation (see below)
27+
28+
## Known Issues / Limitations
29+
- The generated depth is not very high quality right now. The resolution for the depth maps we generate is only 256x256. Some limitations in [Barracuda](https://docs.unity3d.com/Packages/com.unity.barracuda@latest/index.html) require us to use the smaller version of an older depth estimation model ([MiDaS v2.1](https://github.com/isl-org/MiDaS)), but that is only part of the issue. MiDaS in and of itself is not really made for high-resolution, 360° images, which is why people have been researching on how to better approacj high resolution depth estimation . Notably, [360monodepth](https://github.com/manurare/360monodepth) seems to be the state of the art when it comes to generating high resolution depth for panoramic images. The neat thing about Baracuda is that we can run the inference directly in the Unity Editor, or even do it at runtime, but if we want better depth, looking at the setup instructions of the 360monodepth repository, it might require building a web service to do the depth estimation.
30+
31+
## Acknowledgements
32+
Thanks goes out to these wonderful projects:
33+
- Skybox Lab: https://skybox.blockadelabs.com/
34+
- MiDaS v2 integraton: https://github.com/GeorgeAdamon/monocular-depth-unity
35+
- Octahedron Sphere: https://catlikecoding.com/unity/tutorials/octahedron-sphere/

0 commit comments

Comments
 (0)