Add a non-resampled image to the figure.
The image is attached to the lower or upper left corner depending on origin.
The image data. This is an array of one of the following shapes:
The x/y image offset in pixels.
The alpha blending value.
matplotlib.colors.Normalize
A Normalize
instance to map the luminance to the interval [0, 1].
matplotlib.colors.Colormap
, default: rcParams["image.cmap"]
(default: 'viridis'
)
The colormap to use.
If norm is not given, these values set the data limits for the colormap.
rcParams["image.origin"]
(default: 'upper'
)
Indicates where the [0, 0] index of the array is in the upper left or lower left corner of the axes.
If True, resize the figure to match the given image size.
Additional kwargs are Artist
kwargs passed on to FigureImage
.
figimage complements the Axes image (imshow
) which will be resampled to fit the current Axes. If you want a resampled image to fill the entire figure, you can define an Axes
with extent [0, 0, 1, 1].
f = plt.figure() nx = int(f.get_figwidth() * f.dpi) ny = int(f.get_figheight() * f.dpi) data = np.random.random((ny, nx)) f.figimage(data) plt.show()
© 2012–2021 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.5.1/api/_as_gen/matplotlib.pyplot.figimage.html