Plotter.add_background_image(image_path, scale=1.0, auto_resize=True, as_global=True)[source]#

Add a background image to a plot.


Path to an image file.

scalefloat, default: 1.0

Scale the image larger or smaller relative to the size of the window. For example, a scale size of 2 will make the largest dimension of the image twice as large as the largest dimension of the render window.

auto_resizebool, default: True

Resize the background when the render window changes size.

as_globalbool, default: True

When multiple render windows are present, setting as_global=False will cause the background to only appear in one window.


>>> import pyvista as pv
>>> from pyvista import examples
>>> plotter = pv.Plotter()
>>> actor = plotter.add_mesh(pv.Sphere())
>>> plotter.add_background_image(examples.mapfile)