@header@
 
 
matplotlib.backends.backend_ps (version 0.98.0)
index
/home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/backends/backend_ps.py

A PostScript backend, which can produce both PostScript .ps and .eps

 
Modules
       
binascii
glob
math
md5
numpy
os
re
shutil
sys
time

 
Classes
       
matplotlib.backend_bases.FigureCanvasBase
FigureCanvasPS
matplotlib.backend_bases.FigureManagerBase
FigureManagerPS
FigureManagerPS
matplotlib.backend_bases.GraphicsContextBase
GraphicsContextPS
matplotlib.backend_bases.RendererBase
RendererPS

 
class FigureCanvasPS(matplotlib.backend_bases.FigureCanvasBase)
     Methods defined here:
draw(self)
get_default_filetype(self)
print_eps(self, outfile, *args, **kwargs)
print_ps(self, outfile, *args, **kwargs)

Data and other attributes defined here:
filetypes = {'eps': 'Encapsulated Postscript', 'ps': 'Postscript'}

Methods inherited from matplotlib.backend_bases.FigureCanvasBase:
__init__(self, figure)
blit(self, bbox=None)
blit the canvas in bbox (default entire canvas)
button_press_event(self, x, y, button, guiEvent=None)
Backend derived classes should call this function on any mouse
button press.  x,y are the canvas coords: 0,0 is lower, left.
button and key are as defined in MouseEvent
button_release_event(self, x, y, button, guiEvent=None)
Backend derived classes should call this function on any mouse
button release.  x,y are the canvas coords: 0,0 is lower, left.
button and key are as defined in MouseEvent
draw_cursor(self, event)
Draw a cursor in the event.axes if inaxes is not None.  Use
native GUI drawing for efficiency if possible
draw_event(self, renderer)
draw_idle(self, *args, **kwargs)
draw only if idle; defaults to draw but backends can overrride
flush_events(self)
Flush the GUI events for the figure. Implemented only for
backends with GUIs.
get_supported_filetypes(self)
get_supported_filetypes_grouped(self)
get_width_height(self)
return the figure width and height in points or pixels
(depending on the backend), truncated to integers
key_press_event(self, key, guiEvent=None)
key_release_event(self, key, guiEvent=None)
motion_notify_event(self, x, y, guiEvent=None)
Backend derived classes should call this function on any
motion-notify-event. x,y are the canvas coords: 0,0 is lower, left.
button and key are as defined in MouseEvent
mpl_connect(self, s, func)
Connect event with string s to func.  The signature of func is
 
  def func(event)
 
where event is a MplEvent.  The following events are recognized
 
'resize_event',
'draw_event',
'key_press_event',
'key_release_event',
'button_press_event',
'button_release_event',
'scroll_event',
'motion_notify_event',
'pick_event',
 
 
For the three events above, if the mouse is over the axes,
the variable event.inaxes will be set to the axes it is over,
and additionally, the variables event.xdata and event.ydata
will be defined.  This is the mouse location in data coords.
See backend_bases.MplEvent.
 
return value is a connection id that can be used with
mpl_disconnect
mpl_disconnect(self, cid)
disconnect callback id cid
onHilite(self, ev)
Mouse event processor which highlights the artists
under the cursor.  Connect this to the motion_notify_event
using canvas.mpl_connect('motion_notify_event',canvas.onHilite)
onRemove(self, ev)
Mouse event processor which removes the top artist
under the cursor.  Connect this to the mouse_press_event
using canvas.mpl_connect('mouse_press_event',canvas.onRemove)
pick(self, mouseevent)
pick_event(self, mouseevent, artist, **kwargs)
This method will be called by artists who are picked and will
fire off PickEvent callbacks registered listeners
print_bmp = print_raw(self, *args, **kwargs)
print_emf(self, *args, **kwargs)
print_figure(self, filename, dpi=None, facecolor='w', edgecolor='w', orientation='portrait', format=None, **kwargs)
Render the figure to hardcopy. Set the figure patch face and edge
colors.  This is useful because some of the GUIs have a gray figure
face color background and you'll probably want to override this on
hardcopy.
 
filename    - can also be a file object on image backends
orientation - only currently applies to PostScript printing.
dpi - the dots per inch to save the figure in; if None, use savefig.dpi
facecolor - the facecolor of the figure
edgecolor - the edgecolor of the figure
orientation - 'landscape' | 'portrait' (not supported on all backends)
format - when set, forcibly set the file format to save to
print_pdf(self, *args, **kwargs)
print_png(self, *args, **kwargs)
print_raw(self, *args, **kwargs)
print_rgb = print_raw(self, *args, **kwargs)
print_svg(self, *args, **kwargs)
print_svgz(self, *args, **kwargs)
resize(self, w, h)
set the canvas size in pixels
resize_event(self)
scroll_event(self, x, y, button, guiEvent=None)
Backend derived classes should call this function on any
scroll wheel event.  x,y are the canvas coords: 0,0 is lower,
left.  button and key are as defined in MouseEvent
set_window_title(self, title)
Set the title text of the window containing the figure.  Note that
this has no effect if there is no window (eg, a PS backend).
switch_backends(self, FigureCanvasClass)
instantiate an instance of FigureCanvasClass
 
This is used for backend switching, eg, to instantiate a
FigureCanvasPS from a FigureCanvasGTK.  Note, deep copying is
not done, so any changes to one of the instances (eg, setting
figure size or line props), will be reflected in the other

Data and other attributes inherited from matplotlib.backend_bases.FigureCanvasBase:
events = ('resize_event', 'draw_event', 'key_press_event', 'key_release_event', 'button_press_event', 'button_release_event', 'scroll_event', 'motion_notify_event', 'pick_event')

 
FigureManager = class FigureManagerPS(matplotlib.backend_bases.FigureManagerBase)
     Methods inherited from matplotlib.backend_bases.FigureManagerBase:
__init__(self, canvas, num)
destroy(self)
full_screen_toggle(self)
key_press(self, event)
resize(self, w, h)
For gui backends: resize window in pixels
set_window_title(self, title)
Set the title text of the window containing the figure.  Note that
this has no effect if there is no window (eg, a PS backend).
show_popup(self, msg)
Display message in a popup -- GUI only

 
class FigureManagerPS(matplotlib.backend_bases.FigureManagerBase)
     Methods inherited from matplotlib.backend_bases.FigureManagerBase:
__init__(self, canvas, num)
destroy(self)
full_screen_toggle(self)
key_press(self, event)
resize(self, w, h)
For gui backends: resize window in pixels
set_window_title(self, title)
Set the title text of the window containing the figure.  Note that
this has no effect if there is no window (eg, a PS backend).
show_popup(self, msg)
Display message in a popup -- GUI only

 
class GraphicsContextPS(matplotlib.backend_bases.GraphicsContextBase)
     Methods defined here:
get_capstyle(self)
get_joinstyle(self)

Methods inherited from matplotlib.backend_bases.GraphicsContextBase:
__init__(self)
copy_properties(self, gc)
Copy properties from gc to self
get_alpha(self)
Return the alpha value used for blending - not supported on
all backends
get_antialiased(self)
Return true if the object should try to do antialiased rendering
get_clip_path(self)
Return the clip path in the form (path, transform), where path
is a path.Path instance, and transform as an affine transform
to apply to the path before clipping.
get_clip_rectangle(self)
Return the clip rectangle as a Bbox instance
get_dashes(self)
Return the dash information as an offset dashlist tuple The
dash list is a even size list that gives the ink on, ink off
in pixels.  See p107 of to postscript BLUEBOOK for more info
 
Default value is None
get_hatch(self)
Gets the current hatch style
get_linestyle(self, style)
Return the linestyle: one of ('solid', 'dashed', 'dashdot',
'dotted').
get_linewidth(self)
Return the line width in points as a scalar
get_rgb(self)
returns a tuple of three floats from 0-1.  color can be a
matlab format string, a html hex color string, or a rgb tuple
set_alpha(self, alpha)
Set the alpha value used for blending - not supported on
all backends
set_antialiased(self, b)
True if object should be drawn with antialiased rendering
set_capstyle(self, cs)
Set the capstyle as a string in ('butt', 'round', 'projecting')
set_clip_path(self, path)
Set the clip path and transformation.  Path should be a
transforms.TransformedPath instance.
set_clip_rectangle(self, rectangle)
Set the clip rectangle with sequence (left, bottom, width, height)
set_dashes(self, dash_offset, dash_list)
Set the dash style for the gc.
dash_offset is the offset (usually 0).
dash_list specifies the on-off sequence as points
(None, None) specifies a solid line
set_foreground(self, fg, isRGB=False)
Set the foreground color.  fg can be a matlab format string, a
html hex color string, an rgb unit tuple, or a float between 0
and 1.  In the latter case, grayscale is used.
 
The GraphicsContext converts colors to rgb internally.  If you
know the color is rgb already, you can set isRGB to True to
avoid the performace hit of the conversion
set_graylevel(self, frac)
Set the foreground color to be a gray level with frac frac
set_hatch(self, hatch)
Sets the hatch style for filling
set_joinstyle(self, js)
Set the join style to be one of ('miter', 'round', 'bevel')
set_linestyle(self, style)
Set the linestyle to be one of ('solid', 'dashed', 'dashdot',
'dotted').
set_linewidth(self, w)
Set the linewidth in points

Data and other attributes inherited from matplotlib.backend_bases.GraphicsContextBase:
dashd = {'dashdot': (0, (3.0, 5.0, 1.0, 5.0)), 'dashed': (0, (6.0, 6.0)), 'dotted': (0, (1.0, 3.0)), 'solid': (None, None)}

 
class RendererPS(matplotlib.backend_bases.RendererBase)
    The renderer handles all the drawing primitives using a graphics
context instance that controls the colors/styles.
 
  Methods defined here:
__init__(self, width, height, pswriter, dpi=72)
draw_image(self, x, y, im, bbox, clippath=None, clippath_trans=None)
Draw the Image instance into the current axes; x is the
distance in pixels from the left hand side of the canvas and y
is the distance from bottom
 
bbox is a matplotlib.transforms.BBox instance for clipping, or
None
draw_markers(self, gc, marker_path, marker_trans, path, trans, rgbFace=None)
Draw the markers defined by path at each of the positions in x
and y.  path coordinates are points, x and y coords will be
transformed by the transform
draw_mathtext(self, gc, x, y, s, prop, angle)
Draw the math text using matplotlib.mathtext
draw_path(self, gc, path, transform, rgbFace=None)
Draws a Path instance using the given affine transform.
draw_path_collection(self, master_transform, cliprect, clippath, clippath_trans, paths, all_transforms, offsets, offsetTrans, facecolors, edgecolors, linewidths, linestyles, antialiaseds)
draw_tex(self, gc, x, y, s, prop, angle, ismath='TeX!')
draw a Text instance
draw_text(self, gc, x, y, s, prop, angle, ismath)
draw a Text instance
draw_unicode(self, gc, x, y, s, prop, angle)
draw a unicode string.  ps doesn't have unicode support, so
we have to do this the hard way
flipy(self)
return true if small y numbers are top for renderer
get_canvas_width_height(self)
return the canvas width and height in display coords
get_image_magnification(self)
Get the factor by which to magnify images passed to draw_image.
Allows a backend to have images at a different resolution to other
artists.
get_text_width_height_descent(self, s, prop, ismath)
get the width and height in display coords of the string s
with FontPropertry prop
merge_used_characters(self, other)
new_gc(self)
set_color(self, r, g, b, store=1)
set_font(self, fontname, fontsize, store=1)
set_hatch(self, hatch)
hatch can be one of:
    /   - diagonal hatching
    \   - back diagonal
    |   - vertical
    -   - horizontal
    +   - crossed
    X   - crossed diagonal
 
letters can be combined, in which case all the specified
hatchings are done
 
if same letter repeats, it increases the density of hatching
in that direction
set_linecap(self, linecap, store=1)
set_linedash(self, offset, seq, store=1)
set_linejoin(self, linejoin, store=1)
set_linewidth(self, linewidth, store=1)
track_characters(self, font, s)
Keeps track of which characters are required from
each font.

Data and other attributes defined here:
afmfontd = {}
fontd = {}

Methods inherited from matplotlib.backend_bases.RendererBase:
close_group(self, s)
close a grouping element with label s
Is only currently used by backend_svg
draw_quad_mesh(self, master_transform, cliprect, clippath, clippath_trans, meshWidth, meshHeight, coordinates, offsets, offsetTrans, facecolors, antialiased, showedges)
This provides a fallback implementation of draw_quad_mesh that
generates paths and then calls draw_path_collection.
get_texmanager(self)
open_group(self, s)
open a grouping element with label s
Is only currently used by backend_svg
option_image_nocomposite(self)
overwrite this method for renderers that do not necessarily
want to rescale and composite raster images. (like SVG)
points_to_pixels(self, points)
Convert points to display units
points - a float or a numpy array of float
return points converted to pixels
 
You need to override this function (unless your backend doesn't have a
dpi, eg, postscript or svg).
Some imaging systems assume some value for pixels per inch.
points to pixels = points * pixels_per_inch/72.0 * dpi/72.0
start_rasterizing(self)
stop_rasterizing(self)
strip_math(self, s)

 
Functions
       
FT2Font(...)
FT2Font
StringIO(...)
StringIO([s]) -- Return a StringIO-like stream for reading or writing
convert_psfrags(tmpfile, psfrags, font_preamble, custom_preamble, paperWidth, paperHeight, orientation)
When we want to use the LaTeX backend with postscript, we write PSFrag tags
to a temporary postscript file, each one marking a position for LaTeX to
render some text. convert_psfrags generates a LaTeX document containing the
commands to convert those tags to text. LaTeX/dvips produces the postscript
file that includes the actual text.
convert_ttf_to_ps(...)
convert_ttf_to_ps(filename, output, fonttype, glyph_ids)
 
Converts the Truetype font into a Type 3 or Type 42 Postscript font, optionally subsetting the font to only the desired set of characters.
 
filename is the path to a TTF font file.
output is a Python file-like object with a write method that the Postscript font data will be written to.
fonttype may be either 3 or 42.  Type 3 is a "raw Postscript" font. Type 42 is an embedded Truetype font.  Glyph subsetting is not supported for Type 42 fonts.
glyph_ids (optional) is a list of glyph ids (integers) to keep when subsetting to a Type 3 font.  If glyph_ids is not provided or is None, then all glyphs will be included.  If any of the glyphs specified are composite glyphs, then the component glyphs will also be included.
get_bbox(tmpfile, bbox)
Use ghostscript's bbox device to find the center of the bounding box. Return
an appropriately sized bbox centered around that point. A bit of a hack.
gs_distill(tmpfile, eps=False, ptype='letter', bbox=None)
Use ghostscript's pswrite or epswrite device to distill a file.
This yields smaller files without illegal encapsulated postscript
operators. The output is low-level, converting text to outlines.
new_figure_manager(num, *args, **kwargs)
pstoeps(tmpfile, bbox)
Convert the postscript to encapsulated postscript.
quote_ps_string(s)
Quote dangerous characters of S for use in a PostScript string constant.
seq_allequal(seq1, seq2)
seq1 and seq2 are either None or sequences or numerix arrays
Return True if both are None or both are seqs with identical
elements
xpdf_distill(tmpfile, eps=False, ptype='letter', bbox=None)
Use ghostscript's ps2pdf and xpdf's/poppler's pdftops to distill a file.
This yields smaller files without illegal encapsulated postscript
operators. This distiller is preferred, generating high-level postscript
output that treats text as text.

 
Data
        KERNING_DEFAULT = 0
LOAD_NO_HINTING = 2L
__version__ = '0.98.0'
backend_version = 'Level II'
cmd_split = ';'
debugPS = 0
division = _Feature((2, 2, 0, 'alpha', 2), (3, 0, 0, 'alpha', 0), 8192)
get_realpath_and_stat = <matplotlib.cbook.GetRealpathAndStat instance at 0xe22d40>
papersize = {'a0': (33.109999999999999, 46.810000000000002), 'a1': (23.390000000000001, 33.109999999999999), 'a10': (1.02, 1.4570000000000001), 'a2': (16.539999999999999, 23.390000000000001), 'a3': (11.69, 16.539999999999999), 'a4': (8.2699999999999996, 11.69), 'a5': (5.8300000000000001, 8.2699999999999996), 'a6': (4.1299999999999999, 5.8300000000000001), 'a7': (2.9100000000000001, 4.1299999999999999), 'a8': (2.0699999999999998, 2.9100000000000001), ...}
psDefs = ['/m { moveto } bind def', '/l { lineto } bind def', '/r { rlineto } bind def', '/c { curveto } bind def', '/cl { closepath } bind def', '/box {\n m\n 1 index 0 r\n 0 exch r\n neg 0 r\n cl\n } bind def', '/clipbox {\n box\n clip\n newpath\n } bind def']
rcParams = {'figure.subplot.right': 0.90000000000000002, 'm...persize': 'letter', 'svg.embed_char_paths': True}
uni2type1 = {32: 'space', 33: 'exclam', 34: 'quotedbl', 35: 'numbersign', 36: 'dollar', 37: 'percent', 38: 'ampersand', 39: 'quotesingle', 40: 'parenleft', 41: 'parenright', ...}
verbose = <matplotlib.Verbose instance at 0xe47c20>
@footer@