[GRASS-git] [OSGeo/grass] d66691: jupyter: Render 3D images with m.nviz.image (#1831)

[Vaclav Petras]

  Branch: refs/heads/main
  Home:   https://github.com/OSGeo/grass
  Commit: d6669122a9ea0c4cc6654003874a0198bd19d5cd
      https://github.com/OSGeo/grass/commit/d6669122a9ea0c4cc6654003874a0198bd19d5cd
  Author: Vaclav Petras <wenzeslaus at gmail.com>
  Date:   2021-09-02 (Thu, 02 Sep 2021)

  Changed paths:
    M .github/workflows/apt.txt
    M doc/notebooks/grass_jupyter.ipynb
    M python/grass/jupyter/Makefile
    M python/grass/jupyter/__init__.py
    A python/grass/jupyter/render3d.py
    A python/grass/jupyter/testsuite/test_render3d.py

  Log Message:
  -----------
  jupyter: Render 3D images with m.nviz.image (#1831)

* 3D is rendered using m.nviz.image.
* The interface to m.nviz.image is direct/basic, i.e., the parameters are just passed as is.
* There is several special parameters which are handled separately.
* The main function to pass the parameters is called render.
* 2D rendered is used to create 'overlays' such as legend.
* In Binder and other headless environments, PyVirtualDisplay is used to call m.nviz.image.
* Given the API of PyVirtualDisplay, the 3D renderer cannot support custom environments (i.e., it always uses os.environ).
* Supports older pyvirtualdisplay versions by inspecting to see if it already has manage_global_env parameter.
* Adds documentation to the grass.jupyter notebook.
* Add PIL/Pillow to CI (a sort of mandatory dependency for GUI and grass.imaging).