matplotlib.backends.backend_mixed

class matplotlib.backends.backend_mixed.MixedModeRenderer(figure, width, height, dpi, vector_renderer, raster_renderer_class=None, bbox_inches_restore=None)

Bases: object

A helper class to implement a renderer that switches between vector and raster drawing. An example may be a PDF writer, where most things are drawn with PDF vector commands, but some very complex objects, such as quad meshes, are rasterised and then output as images.

Parameters:

figurematplotlib.figure.Figure

The figure instance.

widthscalar

The width of the canvas in logical units

heightscalar

The height of the canvas in logical units

dpifloat

The dpi of the canvas

vector_renderermatplotlib.backend_bases.RendererBase

An instance of a subclass of RendererBase that will be used for the vector drawing.

raster_renderer_classmatplotlib.backend_bases.RendererBase

The renderer class to use for the raster drawing. If not provided, this will use the Agg backend (which is currently the only viable option anyway.)

start_rasterizing(self)

Enter "raster" mode. All subsequent drawing commands (until stop_rasterizing is called) will be drawn with the raster backend.

stop_rasterizing(self)

Exit "raster" mode. All of the drawing that was done since the last start_rasterizing call will be copied to the vector backend by calling draw_image.

If start_rasterizing has been called multiple times, stop_rasterizing must be called the same number of times before "raster" mode is exited.