Add support for Google Earth

Author: eliemichel

README.md

@@ -1,6 +1,5 @@
 *If this helps you save time or money for your job, please consider supporting the work involved in here ;)* [![Donate](https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=DNEEF8GDX2EV6&currency_code=EUR&source=url)
 
-**News** (from Feb 17, 2020) A new version is available that should make the whole process easier and work on more hardware. It now uses the last version of RenderDoc (1.6), the last version of Chrome (80) and the last version of Blender (2.82). This is quite a change and if you notice any regression (like it used to work and now it does not) please report!
 
 Maps Models Importer
 ====================
@@ -68,7 +67,7 @@ Unfortunately, the *inject into process* functionality of RenderDoc is not suppo
 
 ![Importer settings](doc/settings.png)
 
-By default, the addon limits to 200 blocks, but if you feel ready to let your Blender hang for a moment, you can increase it.
+The add-on can limit the number of imported blocks to prevent Blender from freezing too long. If not set to -1 or 0 (meaning no limit), there will be missing blocks in the imported scene, but it'll be quicker (good for testing pipelines, mostly).
 
 ### Blender does not want to install the add-on
 
@@ -127,13 +126,32 @@ You can check out the [LilyTexturePacker](https://gumroad.com/l/DFExj) add-on I'
 
 Although I don't know how to automate the capture itself, you can easily automate the importing part, see [this issue](https://github.com/eliemichel/MapsModelsImporter/issues/39) for an example of automation script.
 
+Notable use cases
+-----------------
+
+I think the most common use case is to sketch out blockings in early stages of architecture perspectives. Another interesting usage is to get a "ground truth" reference when doing match moving or motion tracking on raw footage.
+
+Artistic uses have been reported as well, for instance Benjamin Bardou has been using it to create [stunning](https://www.instagram.com/p/CEH9PAcCG3B/) [images](https://www.instagram.com/p/CENlPPVCVF0/) of Paris.
+
+Feel free to notify me of your use case on twitter [@exppad](https://twitter.com/exppad)!
+
 Disclaimer
 ----------
 
 This is a proof of concept showcasing how the 3D render process of Google Maps can be inspected. This is intended for educational purpose only. For a more in-depth analysis, see [Importing Actual 3D Models From Google Maps](https://blog.exppad.com/article/importing-actual-3d-models-from-google-maps).
 
 Do not use this for any commercial nor redistribution purpose. Actually, the use of such tool might be allowed for private read-only use, as this is what happens when browsing Google Maps, but not beyond. I do not take responsibility for any use of this tool.
 
+Changelog
+---------
+
+For more details, see individual [releases](https://github.com/eliemichel/MapsModelsImporter/releases).
+
+**Aug 23, 2020** *v0.3.0* Captures from Google Earth are now supported. When capturing from Google Earth, there is no need to move around in the viewport when taking the capture. Support for Google Maps is still ensured. Additional add-ons [LilyTexturePacker](https://gumroad.com/l/DFExj) and [LilyCaptureMerger](https://gumroad.com/l/KSvXuu) are compatible with Google Earth Captures.
+
+**Feb 17, 2020** *v0.2.0* A new version is available that should make the whole process easier and work on more hardware. It now uses the last version of RenderDoc (1.6), the last version of Chrome (80) and the last version of Blender (2.82). This is quite a change and if you notice any regression (like it used to work and now it does not) please report!
+
+**Mar 30, 2019** *v0.1.0* Initial release.
 
 Help Wanted
 -----------

blender/MapsModelsImporter/README.md

@@ -1,11 +1,10 @@
-*If this helps you save time or money for your job, please condier supporting the work involved in here ;)* [![Donate](https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=DNEEF8GDX2EV6&currency_code=EUR&source=url)
+*If this helps you save time or money for your job, please consider supporting the work involved in here ;)* [![Donate](https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=DNEEF8GDX2EV6&currency_code=EUR&source=url)
 
-**News** (from Feb 17, 2020) A new version is available that should make the whole process easier and work on more hardware. It now uses the last version of RenderDoc (1.6), the last version of Chrome (80) and the last version of Blender (2.82). This is quite a change and if you notice any regression (like it used to work and now it does not) please report!
 
 Maps Models Importer
 ====================
 
-*Maps Models Importer* is a set of tools for importint 3D models from wide maps in 3D content softwares.
+*Maps Models Importer* is a set of tools for importing 3D models from wide maps in 3D content softwares.
 This is a proof of concept containing only a Blender add-on for importing 3D models from Google Maps.
 
 The `blender` directory contains the source code of the Blender add-on importing captures recorded with [RenderDoc](https://renderdoc.org/):
@@ -15,13 +14,11 @@ The `blender` directory contains the source code of the Blender add-on importing
 Installation
 ------------
 
-Download a [release](https://github.com/eliemichel/MapsModelsImporter/releases) or make a zip of `blender/MapsModelsImporter/`. In Blender 2.82, go to `Edit > Preferences`, `Add-on`, `Install`, then browse to the zip file.
+Download a [release](https://github.com/eliemichel/MapsModelsImporter/releases) or make a zip of `blender/MapsModelsImporter/`. In Blender 2.83, go to `Edit > Preferences`, `Add-on`, `Install`, then browse to the zip file.
 
 **/!\ Do not use the "Download as zip" button of GitHub, make sure you use a release zip instead.**
 
-Install [RenderDoc](https://renderdoc.org/builds) **version 1.6**.
-
-NB: If you are using an older release (v0.1.x and before), you must use the portable version of RenderDoc 1.2 or RenderDoc 1.1. This is no longer the case since v0.2.0 of this add-on.
+Install [RenderDoc](https://renderdoc.org/builds), last version
 
 Usage
 -----
@@ -39,7 +36,9 @@ set RENDERDOC_HOOK_EGL=0
 
   3. Do NOT press Ok on the dialog box yet;
 
-  4. In RenderDoc, search for the chrome process and inject into it;
+  4. In RenderDoc, search for chrome's GPU process and inject into it (you may use the search field);
+
+![Inject into the process called something like "chrome GPU"](doc/injection.png)
 
   5. Press OK in the chrome dialog;
 
@@ -62,43 +61,97 @@ Useful information can be found in the comment of the video, as well as on [the
 
 ### Linux
 
-Unfortunately, the *inject into process* functionality of RenderDoc is not supported on linux.
+Unfortunately, the *inject into process* functionality of RenderDoc is not supported on linux. You can still import existing captures on linux, though.
 
 ### Missing blocks
 
 ![Importer settings](doc/settings.png)
 
-By default, the addon limits to 200 blocks, but if you feel ready to let your Blender hang for a moment, you can increase it.
+The add-on can limit the number of imported blocks to prevent Blender from freezing too long. If not set to -1 or 0 (meaning no limit), there will be missing blocks in the imported scene, but it'll be quicker (good for testing pipelines, mostly).
 
-### I don't want to uninstall Google Chrome...
+### Blender does not want to install the add-on
 
-Since version v0.2.0 of this add-on, it is no longer needed to install an old version of Chrome.
-
-With older versions (depreciated) of this add-on, you have to use a specific version of Chrome. Check this trick out to install it alongside your current version: https://github.com/eliemichel/MapsModelsImporter/issues/15
+Do NOT use the green "Clone or download" button of GitHub. I know it's tempting, but I cannot hide it, it's a GitHub feature. To get the proper zip, go to the [release page](https://github.com/eliemichel/MapsModelsImporter/releases/latest).
 
 ### There is no option for 3D in Google Maps
 
-Try appending `?force=webgl` at the end of the google maps URL.
+Try appending `?force=webgl` at the end of the google maps URL. Also, check that you enabled the Globe mode (an extra button on the right-hand side once you are in satellite mode).
+
+If it is not enough, you can try to change your region to United States because when you are localized in some other area, Google might chose to turn 3D off for some (political?) reason. See [this post](https://blenderartists.org/t/google-maps-models-importer/1153561/176).
 
 ### API: OpenGL (Not Presenting)
 
-This was a common issue with versions of this add-on prior to v0.2.0. Update to the latest version of this add-on, then make sure you remove the `--use-angle=gl` option from the chrome shortcut.
+This was a common issue with versions of this add-on prior to v0.2.0. Update to the latest version of this add-on, then make sure you remove the `--use-angle=gl` option from the chrome shortcut. You should get `API: D3D11`.
+
+### API: None
+
+ - Make sure chrome was completely stopped before starting the custom shortcut
+ - Make sure you have hardware acceleration enabled in the advanced section of the chrome settings.
 
 ### Chrome is showing a warning about an unsupported feature
 
-If this is about the `--disable-gpu-sandbox` flag, it is just a warning, it should not be a problem.
+If chrome says something like "Unsupported command line, security will suffer", don't mind. This is due to the `--disable-gpu-sandbox` flag, but it is just a warning, it should not be a problem for what we are doing.
 
 ### Chrome window is all plain black
 
 Try to set and unset the fullscreen mode using F11.
 
+### There is no GPU pop-up
+
+Make sure you use the right custom shortcut to start chrome and that you closed any process chrome process before starting.
+
+### PrintScr does not actually take a capture
+
+It happens sometimes, in this case you can use the "Capture after delay" button in RenderDoc to trigger a capture. Don't forget to make sure to move in the 3D viewport at the very time the capture occurs.
+
+### How to increase the level of detail?
+
+If you want better quality captures, you should know that Google Maps loads LoDs (Levels of Details) in relation with the window size of your web browser. There is several way to increase it:
+
+ - You can increase your screen resolution. Also note that nvidia allows now to increase the rendering resolution of your screen to 4k even with a simple full HD screen.
+ - You can also use the rendering size percentage in Google Chrome. Most browsers do offer the option to zoom in or out the web pages (typically using Ctrl+Mouse Wheel) to adapt them to your screen resolution. By setting the zoom at e.g. 25% in Google Chrome, you increase the level of detail loaded by Google Maps.
+ - Take several captures and merge them together (see next question)
+
+But while doing so you also increase dramatically the number of block. Be aware of the fact that by default the MapsModelsImporter add-on limits to 200 blocks to prevent from freezing for too long. You can change this number on import.
+
+### How to stitch several captures together?
+
+You can use the [LilyCaptureMerger](https://gumroad.com/l/KSvXuu) add-on for this, here is a quick demo: https://www.youtube.com/watch?v=BcGM76dwF_s
+
+### There are so many textures, it's impractical for export!
+
+You can check out the [LilyTexturePacker](https://gumroad.com/l/DFExj) add-on I've made especially for this. Beware to use it only **after** using LilyTextureMerger, because the latter rely on individual block textures to perform matching.
+
+### It's taking too long, how to automate this process?
+
+Although I don't know how to automate the capture itself, you can easily automate the importing part, see [this issue](https://github.com/eliemichel/MapsModelsImporter/issues/39) for an example of automation script.
+
+Notable use cases
+-----------------
+
+I think the most common use case is to sketch out blockings in early stages of architecture perspectives. Another interesting usage is to get a "ground truth" reference when doing match moving or motion tracking on raw footage.
+
+Artistic uses have been reported as well, for instance Benjamin Bardou has been using it to create [stunning](https://www.instagram.com/p/CEH9PAcCG3B/) [images](https://www.instagram.com/p/CENlPPVCVF0/) of Paris.
+
+Feel free to notify me of your use case on twitter [@exppad](https://twitter.com/exppad)!
+
 Disclaimer
 ----------
 
 This is a proof of concept showcasing how the 3D render process of Google Maps can be inspected. This is intended for educational purpose only. For a more in-depth analysis, see [Importing Actual 3D Models From Google Maps](https://blog.exppad.com/article/importing-actual-3d-models-from-google-maps).
 
 Do not use this for any commercial nor redistribution purpose. Actually, the use of such tool might be allowed for private read-only use, as this is what happens when browsing Google Maps, but not beyond. I do not take responsibility for any use of this tool.
 
+Changelog
+---------
+
+For more details, see individual [releases](https://github.com/eliemichel/MapsModelsImporter/releases).
+
+**Aug 23, 2020** *v0.3.0* Captures from Google Earth are now supported. When capturing from Google Earth, there is no need to move around in the viewport when taking the capture. Support for Google Maps is still ensured. Additional add-ons [LilyTexturePacker](https://gumroad.com/l/DFExj) and [LilyCaptureMerger](https://gumroad.com/l/KSvXuu) are compatible with Google Earth Captures.
+
+**Feb 17, 2020** *v0.2.0* A new version is available that should make the whole process easier and work on more hardware. It now uses the last version of RenderDoc (1.6), the last version of Chrome (80) and the last version of Blender (2.82). This is quite a change and if you notice any regression (like it used to work and now it does not) please report!
+
+**Mar 30, 2019** *v0.1.0* Initial release.
 
 Help Wanted
 -----------

blender/MapsModelsImporter/__init__.py

@@ -24,10 +24,10 @@
 bl_info = {
     "name": "Maps Models Importer",
     "author": "Elie Michel",
-    "version": (0, 2, 2),
+    "version": (0, 3, 0),
     "blender": (2, 82, 0),
     "location": "File > Import > Google Maps Capture",
-    "description": "Import meshes from a Google Maps capture",
+    "description": "Import meshes from a Google Maps or Google Earth capture",
     "warning": "",
     "wiki_url": "",
     "category": "Import-Export",