download_stars_sky_background(texture=False, load=True)[source]#

Download the night sky stars texture.

Textures obtained from tamaskis/planet3D-MATLAB.

texturebool, default: False

Set to True when loading the surface as a texture.

loadbool, default: True

Load the dataset. When False, return the path to the file.

pyvista.DataSet, pyvista.Texture, or str

Texture, Dataset, or path to the file depending on the load and texture parameters.


Load the night sky image as a background image.

>>> from pyvista import examples
>>> import pyvista as pv
>>> pl = pv.Plotter()
>>> image_path = examples.planets.download_stars_sky_background(
...     load=False
... )
>>> pl.add_background_image(image_path)

See load_mars() for another example using this dataset.