pub struct PgfRenderer { /* private fields */ }Expand description
Renders into a PGF picture exactly like matplotlib’s RendererPgf.
Coordinates are display pixels at the figure’s resolution, written in inches.
Implementations§
Source§impl PgfRenderer
impl PgfRenderer
Sourcepub fn new(
width: f64,
height: f64,
dpi: f64,
options: PgfOptions,
) -> Result<Self, VectorError>
pub fn new( width: f64, height: f64, dpi: f64, options: PgfOptions, ) -> Result<Self, VectorError>
A picture of width × height inches drawn at dpi.
§Errors
When the size or resolution is not positive and finite.
Sourcepub fn take_body(&mut self) -> (String, Vec<ImageFile>)
pub fn take_body(&mut self) -> (String, Vec<ImageFile>)
The picture commands drawn since the picture began or the last
call, with the images they include, which leaves the picture empty
(matplotlib’s RendererPgf writes them to its file as it goes).
Sourcepub fn take_ignored_fonts(&mut self) -> Vec<String>
pub fn take_ignored_fonts(&mut self) -> Vec<String>
The families no font has that the texts drawn since the picture
began or the last call asked for, one per text in drawing order,
which leaves none: those matplotlib’s draw_text logs as “Ignoring
unknown font” (see pgf_unknown_family).
Sourcepub fn finish(self) -> Result<PgfDocument, VectorError>
pub fn finish(self) -> Result<PgfDocument, VectorError>
The document (matplotlib’s _print_pgf_to_fh).
§Errors
When an image could not be encoded or written.
Trait Implementations§
Source§impl Debug for PgfRenderer
impl Debug for PgfRenderer
Source§impl Renderer for PgfRenderer
impl Renderer for PgfRenderer
Source§fn draw_tex(
&mut self,
gc: &GraphicsContext,
run: &TextRun,
_tex: &TexText,
origin: Point,
angle: f64,
) -> Result<(), TexError>
fn draw_tex( &mut self, gc: &GraphicsContext, run: &TextRun, _tex: &TexText, origin: Point, angle: f64, ) -> Result<(), TexError>
TeX text goes to LaTeX as it is, like any text (matplotlib’s
draw_tex calls draw_text).
Source§fn canvas_size(&self) -> (f64, f64)
fn canvas_size(&self) -> (f64, f64)
Source§fn draw_path(
&mut self,
gc: &GraphicsContext,
path: &Path,
transform: &Affine2D,
fill: Option<Rgba>,
)
fn draw_path( &mut self, gc: &GraphicsContext, path: &Path, transform: &Affine2D, fill: Option<Rgba>, )
path with gc and fills it with fill, if given.Source§fn draw_markers(
&mut self,
gc: &GraphicsContext,
marker: &Path,
marker_transform: &Affine2D,
path: &Path,
transform: &Affine2D,
fill: Option<Rgba>,
)
fn draw_markers( &mut self, gc: &GraphicsContext, marker: &Path, marker_transform: &Affine2D, path: &Path, transform: &Affine2D, fill: Option<Rgba>, )
marker (in marker coordinates, mapped by marker_transform
to pixel offsets) at every vertex of path transformed by transform.Source§fn draw_gouraud_triangles(
&mut self,
_gc: &GraphicsContext,
_triangles: &[[Point; 3]],
_colors: &[[Rgba; 3]],
_transform: &Affine2D,
)
fn draw_gouraud_triangles( &mut self, _gc: &GraphicsContext, _triangles: &[[Point; 3]], _colors: &[[Rgba; 3]], _transform: &Affine2D, )
transform maps the vertices to display space.Source§fn draw_image(
&mut self,
gc: &GraphicsContext,
origin: Point,
image: &RgbaImage,
transform: Option<&Affine2D>,
)
fn draw_image( &mut self, gc: &GraphicsContext, origin: Point, image: &RgbaImage, transform: Option<&Affine2D>, )
origin (display
coordinates). With transform, the image’s unit square is mapped
through it instead (only used when
option_scale_image is true).Source§fn draw_text(
&mut self,
gc: &GraphicsContext,
run: &TextRun,
origin: Point,
angle: f64,
)
fn draw_text( &mut self, gc: &GraphicsContext, run: &TextRun, origin: Point, angle: f64, )
origin, rotated by angle degrees counter-clockwise about it. Read moreSource§fn option_image_nocomposite(&self) -> bool
fn option_image_nocomposite(&self) -> bool
true, images are drawn one by one instead of being
composited into a single image first.Source§fn option_scale_image(&self) -> bool
fn option_scale_image(&self) -> bool
true, draw_image accepts arbitrary
affine transforms (vector backends); otherwise images arrive
pre-resampled at display resolution.Source§fn points_to_pixels(&self, points: f64) -> f64
fn points_to_pixels(&self, points: f64) -> f64
Source§fn draw_path_collection(
&mut self,
gc: &GraphicsContext,
collection: &PathCollection<'_>,
)
fn draw_path_collection( &mut self, gc: &GraphicsContext, collection: &PathCollection<'_>, )
Source§fn draw_quad_mesh(&mut self, gc: &GraphicsContext, mesh: &QuadMesh<'_>)
fn draw_quad_mesh(&mut self, gc: &GraphicsContext, mesh: &QuadMesh<'_>)
draw_quad_mesh): by
default as a path collection of its cells in matplotlib’s order
(QuadMesh::cell_paths) with the line width of gc.Source§fn draw_text_lines(
&mut self,
_gc: &GraphicsContext,
_text: &TextLines<'_>,
) -> bool
fn draw_text_lines( &mut self, _gc: &GraphicsContext, _text: &TextLines<'_>, ) -> bool
text whole, as matplotlib’s Text.draw hands a renderer a
text’s lines one by one, each with its string, font and artist
(draw_text(gc, x, y, s, prop, angle, ismath, mtext)); whether
the renderer drew it. The renderers of this crate don’t (they draw
each line through draw_text or
draw_tex), a renderer of the program’s does.Source§fn takes_texts_whole(&self) -> bool
fn takes_texts_whole(&self) -> bool
draw_text_lines), which those drawing
texts ask before they describe one.Source§fn rounds_glyph_positions(&self) -> bool
fn rounds_glyph_positions(&self) -> bool
round(0x40 * x)), which refuses a position that is
not finite. Renderers drawing glyphs as paths don’t.Source§fn open_group(&mut self, _name: &str, _gid: Option<&str>)
fn open_group(&mut self, _name: &str, _gid: Option<&str>)
Source§fn close_group(&mut self, _name: &str)
fn close_group(&mut self, _name: &str)
Source§fn open_part_group(&mut self, name: &str, gid: Option<&str>)
fn open_part_group(&mut self, name: &str, gid: Option<&str>)
open_group starts, but the PDF backend does
not set the clip regions again for the parts.Source§fn close_part_group(&mut self, name: &str)
fn close_part_group(&mut self, name: &str)
Source§fn start_rasterizing(&mut self)
fn start_rasterizing(&mut self)
stop_rasterizing (matplotlib’s
start_rasterizing); only vector output distinguishes the modes.Source§fn stop_rasterizing(&mut self)
fn stop_rasterizing(&mut self)
start_rasterizing in the output as an
image and resumes drawing directly.Source§fn raster_dpi(&self) -> Option<f64>
fn raster_dpi(&self) -> Option<f64>
None otherwise. Artists drawn meanwhile
compute their geometry at it, in canvas pixels (matplotlib changes
the figure’s dpi in start_rasterizing).Source§fn start_filter(&mut self)
fn start_filter(&mut self)
stop_filter (matplotlib’s start_filter).
Only raster canvases filter; other backends draw as usual.Source§fn stop_filter(&mut self, _filter: &FilterFn<'_>)
fn stop_filter(&mut self, _filter: &FilterFn<'_>)
start_filter,
cropped to its visible pixels, to filter and draws the image it
returns in its place (matplotlib’s stop_filter).stop_filter with a filter the renderer may
keep, as matplotlib hands renderers the artist’s filter itself: a
renderer passing it on (to a program’s renderer, say) overrides
this; the others filter as stop_filter does.Source§fn image_magnification(&self) -> f64
fn image_magnification(&self) -> f64
get_image_magnification): vector backends rasterize
images at their own resolution rather than at 72 dpi.