@header@
 
 
matplotlib.backends.backend_ps (version 0.71)
index
/usr/local/lib/python2.3/site-packages/matplotlib/backends/backend_ps.py

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

 
Modules
       
binascii
os
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)
print_figure(self, outfile, dpi=72, facecolor='w', edgecolor='w', orientation='portrait')
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
 
If outfile is a string, it is interpreted as a file name.
If the extension matches .ep* write encapsulated postscript,
otherwise write a stand-alone PostScript file.
 
If outfile is a file object, a stand-alone PostScript file is
written into this file object.

Data and other attributes defined here:
basepath = '/usr/local/share/matplotlib'

Methods inherited from matplotlib.backend_bases.FigureCanvasBase:
__init__(self, figure)
button_press_event(self, x, y, button)
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)
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
key_press_event(self, key)
key_release_event(self, key)
motion_notify_event(self, x, y)
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
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
 
 'key_press_event' 
 'button_press_event' 
 'button_release_event' 
 'motion_notify_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)
Connect s to func. return an id that can be used with disconnect
Method should return None
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 = ('key_press_event', 'key_release_event', 'button_press_event', 'button_release_event', 'motion_notify_event')

 
FigureManager = class FigureManagerPS(matplotlib.backend_bases.FigureManagerBase)
     Methods inherited from matplotlib.backend_bases.FigureManagerBase:
__init__(self, canvas, num)
clf(self)
clear the figure
destroy(self)

 
class FigureManagerPS(matplotlib.backend_bases.FigureManagerBase)
     Methods inherited from matplotlib.backend_bases.FigureManagerBase:
__init__(self, canvas, num)
clf(self)
clear the figure
destroy(self)

 
class GraphicsContextPS(matplotlib.backend_bases.GraphicsContextBase)
     Methods defined here:
set_linestyle(self, style)
Set the linestyle to be one of ('solid', 'dashed', 'dashdot',
'dotted').

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_capstyle(self)
Return the capstyle as a string in ('butt', 'round', 'projecting')
get_clip_rectangle(self)
Return the clip rectangle as (left, bottom, width, height)
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_joinstyle(self)
Return the line join style as one of ('miter', 'round', 'bevel')
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_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
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_joinstyle(self, js)
Set the join style to be one of ('miter', 'round', 'bevel')
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)
draw_arc(self, gc, rgbFace, x, y, width, height, angle1, angle2)
Draw an arc centered at x,y with width and height and angles
from 0.0 to 360.0
 
If gcFace is not None, fill the arc slice with it.  gcEdge
is a GraphicsContext instance
draw_image(self, x, y, im, origin, bbox)
Draw the Image instance into the current axes; x is the
distance in pixels from the left hand side of the canvas. y is
the distance from the origin.  That is, if origin is upper, y
is the distance from top.  If origin is lower, y is the
distance from bottom
 
origin is 'upper' or 'lower'
 
bbox is a matplotlib.transforms.BBox instance for clipping, or
None
draw_line(self, gc, x0, y0, x1, y1)
Draw a single line from x0,y0 to x1,y1
draw_lines(self, gc, x, y)
x and y are equal length arrays, draw lines connecting each
point in x, y
draw_mathtext(self, gc, x, y, s, prop, angle)
Draw the math text using matplotlib.mathtext
draw_point(self, gc, x, y)
Draw a single point at x,y
draw_polygon(self, gc, rgbFace, points)
Draw a polygon.  points is a len vertices tuple, each element
giving the x,y coords a vertex
 
If rgbFace is not None, fill the poly with it.  gc
is a GraphicsContext instance
draw_rectangle(self, gc, rgbFace, x, y, width, height)
Draw a rectangle with lower left at x,y with width and height.
 
If gcFace is not None, fill the rectangle with it.  gcEdge
is a GraphicsContext instance
draw_text(self, gc, x, y, s, prop, angle, ismath)
draw a Text instance
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_text_width_height(self, s, prop, ismath)
get the width and height in display coords of the string s
with FontPropertry prop
new_gc(self)
set_color(self, r, g, b, store=1)
set_font(self, fontname, fontsize)
set_linecap(self, linecap)
set_linedash(self, offset, seq)
set_linejoin(self, linejoin)
set_linewidth(self, linewidth)

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_line_collection(self, segments, transform, clipbox, colors, linewidths, linestyle, antialiaseds, offsets, transOffset)
This is a function for optimized line drawing.  If you need to
draw many line segments with similar properties, it is faster
to avoid the overhead of all the object creation etc.  The
lack of total configurability is compensated for with
efficiency.  Hence we don't use a GC and many of the line
props it supports.  See matplotlib.collections for more
details
 
sements is a sequence of ( line0, line1, line2), where linen =
(x0, y0), (x1, y1), ... (xm, ym).  Each line can be a
different length
 
transform is used to Transform the lines
 
clipbox is a  xmin, ymin, width, height clip rect
 
colors is a tuple of RGBA tuples
 
linewidths is a tuple of linewidths
 
linestyle is an (offset, onoffseq) tuple or None,None for solid
 
antialiseds is a tuple of ones or zeros indicating whether the
segment should be aa or not
 
offsets, if not None, is a list of x,y offsets to translate
the lines by after transoff is used to transform the offset
coords
 
This function is intended to be overridden by the backend
level in extension code for backends that want fast line
collection drawing.  Here is is implemented using native
backend calls and may be slow
draw_poly_collection(self, verts, transform, clipbox, facecolors, edgecolors, linewidths, antialiaseds, offsets, transOffset)
Draw a polygon collection
 
verts are a sequence of polygon vectors, where each polygon
vector is a sequence of x,y tuples of vertices
 
facecolors and edgecolors are a sequence of RGBA tuples
linewidths are a sequence of linewidths
antialiaseds are a sequence of 0,1 integers whether to use aa
draw_regpoly_collection(self, clipbox, offsets, transOffset, verts, sizes, facecolors, edgecolors, linewidths, antialiaseds)
Draw a regular poly collection
 
offsets is a sequence is x,y tuples and transOffset maps this
to display coords
 
verts are the vertices of the regular polygon at the origin
 
sizes are the area of the circle that circumscribes the
polygon in points^2
 
facecolors and edgecolors are a sequence of RGBA tuples
linewidths are a sequence of linewidths
antialiaseds are a sequence of 0,1 integers whether to use aa
get_text_extent(self, text)
Get the text extent in window coords
open_group(self, s)
open a grouping element with label s
Is only currently used by backend_svg
points_to_pixels(self, points)
Convert points to display units (as a float).
You need to override this function (unless your backend doesn't have
dpi, eg, postscript or svg).
Many imaging systems assume some value for pixels per inch.
points to pixels = points * pixels_per_inch/72.0 * dpi/72.0
strip_math(self, s)

 
Functions
       
FT2Font(...)
FT2Font
StringIO(...)
StringIO([s]) -- Return a StringIO-like stream for reading or writing
encodeTTFasPS(fontfile)
Encode a TrueType font file for embedding in a PS file.
error_msg = error_msg_ps(msg, *args)
Signal an error condition.
error_msg_ps(msg, *args)
Signal an error condition.
fromstring(...)
fromstring(string, typecode='l', count=-1) returns a new 1d array initialized from the raw binary data in string.  If count is positive, the new array will have count elements, otherwise it's size is determined by the size of string.
new_figure_manager(num, *args, **kwargs)
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

 
Data
        Float32 = 'f'
UInt8 = 'b'
__version__ = '0.71'
backend_version = 'Level II'
bakoma_fonts = []
debugPS = 0
defaultPaperSize = (8.5, 11)
division = _Feature((2, 2, 0, 'alpha', 2), (3, 0, 0, 'alpha', 0), 8192)
equal = <ufunc 'equal'>
fontManager = <matplotlib.font_manager.FontManager instance>
verbose = <matplotlib.Verbose instance>
@footer@