641 lines (513 with data), 51.9 kB
@header@
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
<tr bgcolor="#7799ee">
<td valign=bottom> <br>
<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="matplotlib.html"><font color="#ffffff">matplotlib</font></a>.<a href="matplotlib.backends.html"><font color="#ffffff">backends</font></a>.backend_ps</strong></big></big> (version 0.98.3)</font></td
><td align=right valign=bottom
><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/backends/backend_ps.py">/home/jdhunter/dev/lib64/python2.5/site-packages/matplotlib/backends/backend_ps.py</a></font></td></tr></table>
<p><tt>A PostScript backend, which can produce both PostScript .ps and .eps</tt></p>
<p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#aa55cc">
<td colspan=3 valign=bottom> <br>
<font color="#fffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="binascii.html">binascii</a><br>
<a href="glob.html">glob</a><br>
<a href="math.html">math</a><br>
</td><td width="25%" valign=top><a href="numpy.html">numpy</a><br>
<a href="os.html">os</a><br>
<a href="re.html">re</a><br>
</td><td width="25%" valign=top><a href="shutil.html">shutil</a><br>
<a href="sys.html">sys</a><br>
<a href="time.html">time</a><br>
</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#ee77aa">
<td colspan=3 valign=bottom> <br>
<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
<td width="100%"><dl>
<dt><font face="helvetica, arial"><a href="matplotlib.backend_bases.html#FigureCanvasBase">matplotlib.backend_bases.FigureCanvasBase</a>
</font></dt><dd>
<dl>
<dt><font face="helvetica, arial"><a href="matplotlib.backends.backend_ps.html#FigureCanvasPS">FigureCanvasPS</a>
</font></dt></dl>
</dd>
<dt><font face="helvetica, arial"><a href="matplotlib.backend_bases.html#FigureManagerBase">matplotlib.backend_bases.FigureManagerBase</a>
</font></dt><dd>
<dl>
<dt><font face="helvetica, arial"><a href="matplotlib.backends.backend_ps.html#FigureManagerPS">FigureManagerPS</a>
</font></dt><dt><font face="helvetica, arial"><a href="matplotlib.backends.backend_ps.html#FigureManagerPS">FigureManagerPS</a>
</font></dt></dl>
</dd>
<dt><font face="helvetica, arial"><a href="matplotlib.backend_bases.html#GraphicsContextBase">matplotlib.backend_bases.GraphicsContextBase</a>
</font></dt><dd>
<dl>
<dt><font face="helvetica, arial"><a href="matplotlib.backends.backend_ps.html#GraphicsContextPS">GraphicsContextPS</a>
</font></dt></dl>
</dd>
<dt><font face="helvetica, arial"><a href="matplotlib.backend_bases.html#RendererBase">matplotlib.backend_bases.RendererBase</a>
</font></dt><dd>
<dl>
<dt><font face="helvetica, arial"><a href="matplotlib.backends.backend_ps.html#RendererPS">RendererPS</a>
</font></dt></dl>
</dd>
</dl>
<p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#ffc8d8">
<td colspan=3 valign=bottom> <br>
<font color="#000000" face="helvetica, arial"><a name="FigureCanvasPS">class <strong>FigureCanvasPS</strong></a>(<a href="matplotlib.backend_bases.html#FigureCanvasBase">matplotlib.backend_bases.FigureCanvasBase</a>)</font></td></tr>
<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
<td width="100%">Methods defined here:<br>
<dl><dt><a name="FigureCanvasPS-draw"><strong>draw</strong></a>(self)</dt></dl>
<dl><dt><a name="FigureCanvasPS-get_default_filetype"><strong>get_default_filetype</strong></a>(self)</dt></dl>
<dl><dt><a name="FigureCanvasPS-print_eps"><strong>print_eps</strong></a>(self, outfile, *args, **kwargs)</dt></dl>
<dl><dt><a name="FigureCanvasPS-print_ps"><strong>print_ps</strong></a>(self, outfile, *args, **kwargs)</dt></dl>
<hr>
Data and other attributes defined here:<br>
<dl><dt><strong>filetypes</strong> = {'eps': 'Encapsulated Postscript', 'ps': 'Postscript'}</dl>
<hr>
Methods inherited from <a href="matplotlib.backend_bases.html#FigureCanvasBase">matplotlib.backend_bases.FigureCanvasBase</a>:<br>
<dl><dt><a name="FigureCanvasPS-__init__"><strong>__init__</strong></a>(self, figure)</dt></dl>
<dl><dt><a name="FigureCanvasPS-blit"><strong>blit</strong></a>(self, bbox<font color="#909090">=None</font>)</dt><dd><tt>blit the canvas in bbox (default entire canvas)</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-button_press_event"><strong>button_press_event</strong></a>(self, x, y, button, guiEvent<font color="#909090">=None</font>)</dt><dd><tt>Backend derived classes should call this function on any mouse<br>
button press. x,y are the canvas coords: 0,0 is lower, left.<br>
button and key are as defined in :class:`MouseEvent`.<br>
<br>
This method will be call all functions connected to the<br>
'button_press_event' with a :class:`MouseEvent` instance.</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-button_release_event"><strong>button_release_event</strong></a>(self, x, y, button, guiEvent<font color="#909090">=None</font>)</dt><dd><tt>Backend derived classes should call this function on any mouse<br>
button release.<br>
<br>
*x*<br>
the canvas coordinates where 0=left<br>
<br>
*y*<br>
the canvas coordinates where 0=bottom<br>
<br>
*guiEvent*<br>
the native UI event that generated the mpl event<br>
<br>
<br>
This method will be call all functions connected to the<br>
'button_release_event' with a :class:`MouseEvent` instance.</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-draw_cursor"><strong>draw_cursor</strong></a>(self, event)</dt><dd><tt>Draw a cursor in the event.axes if inaxes is not None. Use<br>
native GUI drawing for efficiency if possible</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-draw_event"><strong>draw_event</strong></a>(self, renderer)</dt><dd><tt>This method will be call all functions connected to the<br>
'draw_event' with a :class:`DrawEvent`</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-draw_idle"><strong>draw_idle</strong></a>(self, *args, **kwargs)</dt><dd><tt>:meth:`draw` only if idle; defaults to draw but backends can overrride</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-flush_events"><strong>flush_events</strong></a>(self)</dt><dd><tt>Flush the GUI events for the figure. Implemented only for<br>
backends with GUIs.</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-get_supported_filetypes"><strong>get_supported_filetypes</strong></a>(self)</dt></dl>
<dl><dt><a name="FigureCanvasPS-get_supported_filetypes_grouped"><strong>get_supported_filetypes_grouped</strong></a>(self)</dt></dl>
<dl><dt><a name="FigureCanvasPS-get_width_height"><strong>get_width_height</strong></a>(self)</dt><dd><tt>return the figure width and height in points or pixels<br>
(depending on the backend), truncated to integers</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-idle_event"><strong>idle_event</strong></a>(self, guiEvent<font color="#909090">=None</font>)</dt><dd><tt>call when GUI is idle</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-key_press_event"><strong>key_press_event</strong></a>(self, key, guiEvent<font color="#909090">=None</font>)</dt><dd><tt>This method will be call all functions connected to the<br>
'key_press_event' with a :class:`KeyEvent`</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-key_release_event"><strong>key_release_event</strong></a>(self, key, guiEvent<font color="#909090">=None</font>)</dt><dd><tt>This method will be call all functions connected to the<br>
'key_release_event' with a :class:`KeyEvent`</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-motion_notify_event"><strong>motion_notify_event</strong></a>(self, x, y, guiEvent<font color="#909090">=None</font>)</dt><dd><tt>Backend derived classes should call this function on any<br>
motion-notify-event.<br>
<br>
*x*<br>
the canvas coordinates where 0=left<br>
<br>
*y*<br>
the canvas coordinates where 0=bottom<br>
<br>
*guiEvent*<br>
the native UI event that generated the mpl event<br>
<br>
<br>
This method will be call all functions connected to the<br>
'motion_notify_event' with a :class:`MouseEvent` instance.</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-mpl_connect"><strong>mpl_connect</strong></a>(self, s, func)</dt><dd><tt>Connect event with string *s* to *func*. The signature of *func* is::<br>
<br>
def func(event)<br>
<br>
where event is a :class:`matplotlib.backend_bases.Event`. The<br>
following events are recognized<br>
<br>
- 'button_press_event'<br>
- 'button_release_event'<br>
- 'draw_event'<br>
- 'key_press_event'<br>
- 'key_release_event'<br>
- 'motion_notify_event'<br>
- 'pick_event'<br>
- 'resize_event'<br>
- 'scroll_event'<br>
<br>
For the location events (button and key press/release), if the<br>
mouse is over the axes, the variable ``event.inaxes`` will be<br>
set to the :class:`~matplotlib.axes.Axes` the event occurs is<br>
over, and additionally, the variables ``event.xdata`` and<br>
``event.ydata`` will be defined. This is the mouse location<br>
in data coords. See<br>
:class:`~matplotlib.backend_bases.KeyEvent` and<br>
:class:`~matplotlib.backend_bases.MouseEvent` for more info.<br>
<br>
Return value is a connection id that can be used with<br>
:meth:`~matplotlib.backend_bases.Event.mpl_disconnect`.<br>
<br>
Example usage::<br>
<br>
def on_press(event):<br>
print 'you pressed', event.button, event.xdata, event.ydata<br>
<br>
cid = canvas.<a href="#FigureCanvasPS-mpl_connect">mpl_connect</a>('button_press_event', on_press)</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-mpl_disconnect"><strong>mpl_disconnect</strong></a>(self, cid)</dt><dd><tt>disconnect callback id cid<br>
<br>
Example usage::<br>
<br>
cid = canvas.<a href="#FigureCanvasPS-mpl_connect">mpl_connect</a>('button_press_event', on_press)<br>
#...later<br>
canvas.<a href="#FigureCanvasPS-mpl_disconnect">mpl_disconnect</a>(cid)</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-onHilite"><strong>onHilite</strong></a>(self, ev)</dt><dd><tt>Mouse event processor which highlights the artists<br>
under the cursor. Connect this to the 'motion_notify_event'<br>
using::<br>
<br>
canvas.<a href="#FigureCanvasPS-mpl_connect">mpl_connect</a>('motion_notify_event',canvas.onHilite)</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-onRemove"><strong>onRemove</strong></a>(self, ev)</dt><dd><tt>Mouse event processor which removes the top artist<br>
under the cursor. Connect this to the 'mouse_press_event'<br>
using::<br>
<br>
canvas.<a href="#FigureCanvasPS-mpl_connect">mpl_connect</a>('mouse_press_event',canvas.onRemove)</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-pick"><strong>pick</strong></a>(self, mouseevent)</dt></dl>
<dl><dt><a name="FigureCanvasPS-pick_event"><strong>pick_event</strong></a>(self, mouseevent, artist, **kwargs)</dt><dd><tt>This method will be called by artists who are picked and will<br>
fire off :class:`PickEvent` callbacks registered listeners</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-print_bmp"><strong>print_bmp</strong></a> = print_raw(self, *args, **kwargs)</dt></dl>
<dl><dt><a name="FigureCanvasPS-print_emf"><strong>print_emf</strong></a>(self, *args, **kwargs)</dt></dl>
<dl><dt><a name="FigureCanvasPS-print_figure"><strong>print_figure</strong></a>(self, filename, dpi<font color="#909090">=None</font>, facecolor<font color="#909090">='w'</font>, edgecolor<font color="#909090">='w'</font>, orientation<font color="#909090">='portrait'</font>, format<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Render the figure to hardcopy. Set the figure patch face and edge<br>
colors. This is useful because some of the GUIs have a gray figure<br>
face color background and you'll probably want to override this on<br>
hardcopy.<br>
<br>
Arguments are:<br>
<br>
*filename*<br>
can also be a file object on image backends<br>
<br>
*orientation*<br>
only currently applies to PostScript printing.<br>
<br>
*dpi*<br>
the dots per inch to save the figure in; if None, use savefig.dpi<br>
<br>
*facecolor*<br>
the facecolor of the figure<br>
<br>
*edgecolor*<br>
the edgecolor of the figure<br>
<br>
*orientation* '<br>
landscape' | 'portrait' (not supported on all backends)<br>
<br>
*format*<br>
when set, forcibly set the file format to save to</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-print_pdf"><strong>print_pdf</strong></a>(self, *args, **kwargs)</dt></dl>
<dl><dt><a name="FigureCanvasPS-print_png"><strong>print_png</strong></a>(self, *args, **kwargs)</dt></dl>
<dl><dt><a name="FigureCanvasPS-print_raw"><strong>print_raw</strong></a>(self, *args, **kwargs)</dt></dl>
<dl><dt><a name="FigureCanvasPS-print_rgb"><strong>print_rgb</strong></a> = print_raw(self, *args, **kwargs)</dt></dl>
<dl><dt><a name="FigureCanvasPS-print_svg"><strong>print_svg</strong></a>(self, *args, **kwargs)</dt></dl>
<dl><dt><a name="FigureCanvasPS-print_svgz"><strong>print_svgz</strong></a>(self, *args, **kwargs)</dt></dl>
<dl><dt><a name="FigureCanvasPS-resize"><strong>resize</strong></a>(self, w, h)</dt><dd><tt>set the canvas size in pixels</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-resize_event"><strong>resize_event</strong></a>(self)</dt><dd><tt>This method will be call all functions connected to the<br>
'resize_event' with a :class:`ResizeEvent`</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-scroll_event"><strong>scroll_event</strong></a>(self, x, y, step, guiEvent<font color="#909090">=None</font>)</dt><dd><tt>Backend derived classes should call this function on any<br>
scroll wheel event. x,y are the canvas coords: 0,0 is lower,<br>
left. button and key are as defined in MouseEvent.<br>
<br>
This method will be call all functions connected to the<br>
'scroll_event' with a :class:`MouseEvent` instance.</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-set_window_title"><strong>set_window_title</strong></a>(self, title)</dt><dd><tt>Set the title text of the window containing the figure. Note that<br>
this has no effect if there is no window (eg, a PS backend).</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-start_event_loop"><strong>start_event_loop</strong></a>(self, timeout)</dt><dd><tt>Start an event loop. This is used to start a blocking event<br>
loop so that interactive functions, such as ginput and<br>
waitforbuttonpress, can wait for events. This should not be<br>
confused with the main GUI event loop, which is always running<br>
and has nothing to do with this.<br>
<br>
This is implemented only for backends with GUIs.</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-start_event_loop_default"><strong>start_event_loop_default</strong></a>(self, timeout<font color="#909090">=0</font>)</dt><dd><tt>Start an event loop. This is used to start a blocking event<br>
loop so that interactive functions, such as ginput and<br>
waitforbuttonpress, can wait for events. This should not be<br>
confused with the main GUI event loop, which is always running<br>
and has nothing to do with this.<br>
<br>
This function provides default event loop functionality based<br>
on time.sleep that is meant to be used until event loop<br>
functions for each of the GUI backends can be written. As<br>
such, it throws a deprecated warning.<br>
<br>
Call signature::<br>
<br>
<a href="#FigureCanvasPS-start_event_loop_default">start_event_loop_default</a>(self,timeout=0)<br>
<br>
This call blocks until a callback function triggers<br>
<a href="#FigureCanvasPS-stop_event_loop">stop_event_loop</a>() or *timeout* is reached. If *timeout* is<br>
<=0, never timeout.</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-stop_event_loop"><strong>stop_event_loop</strong></a>(self)</dt><dd><tt>Stop an event loop. This is used to stop a blocking event<br>
loop so that interactive functions, such as ginput and<br>
waitforbuttonpress, can wait for events.<br>
<br>
This is implemented only for backends with GUIs.</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-stop_event_loop_default"><strong>stop_event_loop_default</strong></a>(self)</dt><dd><tt>Stop an event loop. This is used to stop a blocking event<br>
loop so that interactive functions, such as ginput and<br>
waitforbuttonpress, can wait for events.<br>
<br>
Call signature::<br>
<br>
<a href="#FigureCanvasPS-stop_event_loop_default">stop_event_loop_default</a>(self)</tt></dd></dl>
<dl><dt><a name="FigureCanvasPS-switch_backends"><strong>switch_backends</strong></a>(self, FigureCanvasClass)</dt><dd><tt>instantiate an instance of FigureCanvasClass<br>
<br>
This is used for backend switching, eg, to instantiate a<br>
<a href="#FigureCanvasPS">FigureCanvasPS</a> from a FigureCanvasGTK. Note, deep copying is<br>
not done, so any changes to one of the instances (eg, setting<br>
figure size or line props), will be reflected in the other</tt></dd></dl>
<hr>
Data and other attributes inherited from <a href="matplotlib.backend_bases.html#FigureCanvasBase">matplotlib.backend_bases.FigureCanvasBase</a>:<br>
<dl><dt><strong>events</strong> = ['resize_event', 'draw_event', 'key_press_event', 'key_release_event', 'button_press_event', 'button_release_event', 'scroll_event', 'motion_notify_event', 'pick_event', 'idle_event']</dl>
</td></tr></table> <p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#ffc8d8">
<td colspan=3 valign=bottom> <br>
<font color="#000000" face="helvetica, arial"><strong>FigureManager</strong> = <a name="FigureManager">class FigureManagerPS</a>(<a href="matplotlib.backend_bases.html#FigureManagerBase">matplotlib.backend_bases.FigureManagerBase</a>)</font></td></tr>
<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
<td width="100%">Methods inherited from <a href="matplotlib.backend_bases.html#FigureManagerBase">matplotlib.backend_bases.FigureManagerBase</a>:<br>
<dl><dt><a name="FigureManagerPS-__init__"><strong>__init__</strong></a>(self, canvas, num)</dt></dl>
<dl><dt><a name="FigureManagerPS-destroy"><strong>destroy</strong></a>(self)</dt></dl>
<dl><dt><a name="FigureManagerPS-full_screen_toggle"><strong>full_screen_toggle</strong></a>(self)</dt></dl>
<dl><dt><a name="FigureManagerPS-key_press"><strong>key_press</strong></a>(self, event)</dt></dl>
<dl><dt><a name="FigureManagerPS-resize"><strong>resize</strong></a>(self, w, h)</dt><dd><tt>For gui backends: resize window in pixels</tt></dd></dl>
<dl><dt><a name="FigureManagerPS-set_window_title"><strong>set_window_title</strong></a>(self, title)</dt><dd><tt>Set the title text of the window containing the figure. Note that<br>
this has no effect if there is no window (eg, a PS backend).</tt></dd></dl>
<dl><dt><a name="FigureManagerPS-show_popup"><strong>show_popup</strong></a>(self, msg)</dt><dd><tt>Display message in a popup -- GUI only</tt></dd></dl>
</td></tr></table> <p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#ffc8d8">
<td colspan=3 valign=bottom> <br>
<font color="#000000" face="helvetica, arial"><a name="FigureManagerPS">class <strong>FigureManagerPS</strong></a>(<a href="matplotlib.backend_bases.html#FigureManagerBase">matplotlib.backend_bases.FigureManagerBase</a>)</font></td></tr>
<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
<td width="100%">Methods inherited from <a href="matplotlib.backend_bases.html#FigureManagerBase">matplotlib.backend_bases.FigureManagerBase</a>:<br>
<dl><dt><a name="FigureManagerPS-__init__"><strong>__init__</strong></a>(self, canvas, num)</dt></dl>
<dl><dt><a name="FigureManagerPS-destroy"><strong>destroy</strong></a>(self)</dt></dl>
<dl><dt><a name="FigureManagerPS-full_screen_toggle"><strong>full_screen_toggle</strong></a>(self)</dt></dl>
<dl><dt><a name="FigureManagerPS-key_press"><strong>key_press</strong></a>(self, event)</dt></dl>
<dl><dt><a name="FigureManagerPS-resize"><strong>resize</strong></a>(self, w, h)</dt><dd><tt>For gui backends: resize window in pixels</tt></dd></dl>
<dl><dt><a name="FigureManagerPS-set_window_title"><strong>set_window_title</strong></a>(self, title)</dt><dd><tt>Set the title text of the window containing the figure. Note that<br>
this has no effect if there is no window (eg, a PS backend).</tt></dd></dl>
<dl><dt><a name="FigureManagerPS-show_popup"><strong>show_popup</strong></a>(self, msg)</dt><dd><tt>Display message in a popup -- GUI only</tt></dd></dl>
</td></tr></table> <p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#ffc8d8">
<td colspan=3 valign=bottom> <br>
<font color="#000000" face="helvetica, arial"><a name="GraphicsContextPS">class <strong>GraphicsContextPS</strong></a>(<a href="matplotlib.backend_bases.html#GraphicsContextBase">matplotlib.backend_bases.GraphicsContextBase</a>)</font></td></tr>
<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
<td width="100%">Methods defined here:<br>
<dl><dt><a name="GraphicsContextPS-get_capstyle"><strong>get_capstyle</strong></a>(self)</dt></dl>
<dl><dt><a name="GraphicsContextPS-get_joinstyle"><strong>get_joinstyle</strong></a>(self)</dt></dl>
<hr>
Methods inherited from <a href="matplotlib.backend_bases.html#GraphicsContextBase">matplotlib.backend_bases.GraphicsContextBase</a>:<br>
<dl><dt><a name="GraphicsContextPS-__init__"><strong>__init__</strong></a>(self)</dt></dl>
<dl><dt><a name="GraphicsContextPS-copy_properties"><strong>copy_properties</strong></a>(self, gc)</dt><dd><tt>Copy properties from gc to self</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-get_alpha"><strong>get_alpha</strong></a>(self)</dt><dd><tt>Return the alpha value used for blending - not supported on<br>
all backends</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-get_antialiased"><strong>get_antialiased</strong></a>(self)</dt><dd><tt>Return true if the object should try to do antialiased rendering</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-get_clip_path"><strong>get_clip_path</strong></a>(self)</dt><dd><tt>Return the clip path in the form (path, transform), where path<br>
is a :class:`~matplotlib.path.Path` instance, and transform is<br>
an affine transform to apply to the path before clipping.</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-get_clip_rectangle"><strong>get_clip_rectangle</strong></a>(self)</dt><dd><tt>Return the clip rectangle as a :class:`~matplotlib.transforms.Bbox` instance</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-get_dashes"><strong>get_dashes</strong></a>(self)</dt><dd><tt>Return the dash information as an offset dashlist tuple The<br>
dash list is a even size list that gives the ink on, ink off<br>
in pixels. See p107 of to postscript `BLUEBOOK<br>
<<a href="http://www-cdf.fnal.gov/offline/PostScript/BLUEBOOK.PDF>`_">http://www-cdf.fnal.gov/offline/PostScript/BLUEBOOK.PDF>`_</a><br>
for more info<br>
<br>
Default value is None</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-get_hatch"><strong>get_hatch</strong></a>(self)</dt><dd><tt>Gets the current hatch style</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-get_linestyle"><strong>get_linestyle</strong></a>(self, style)</dt><dd><tt>Return the linestyle: one of ('solid', 'dashed', 'dashdot',<br>
'dotted').</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-get_linewidth"><strong>get_linewidth</strong></a>(self)</dt><dd><tt>Return the line width in points as a scalar</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-get_rgb"><strong>get_rgb</strong></a>(self)</dt><dd><tt>returns a tuple of three floats from 0-1. color can be a<br>
matlab format string, a html hex color string, or a rgb tuple</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-set_alpha"><strong>set_alpha</strong></a>(self, alpha)</dt><dd><tt>Set the alpha value used for blending - not supported on<br>
all backends</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-set_antialiased"><strong>set_antialiased</strong></a>(self, b)</dt><dd><tt>True if object should be drawn with antialiased rendering</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-set_capstyle"><strong>set_capstyle</strong></a>(self, cs)</dt><dd><tt>Set the capstyle as a string in ('butt', 'round', 'projecting')</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-set_clip_path"><strong>set_clip_path</strong></a>(self, path)</dt><dd><tt>Set the clip path and transformation. Path should be a<br>
:class:`~matplotlib.transforms.TransformedPath` instance.</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-set_clip_rectangle"><strong>set_clip_rectangle</strong></a>(self, rectangle)</dt><dd><tt>Set the clip rectangle with sequence (left, bottom, width, height)</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-set_dashes"><strong>set_dashes</strong></a>(self, dash_offset, dash_list)</dt><dd><tt>Set the dash style for the gc.<br>
<br>
*dash_offset*<br>
is the offset (usually 0).<br>
<br>
*dash_list*<br>
specifies the on-off sequence as points. ``(None, None)`` specifies a solid line</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-set_foreground"><strong>set_foreground</strong></a>(self, fg, isRGB<font color="#909090">=False</font>)</dt><dd><tt>Set the foreground color. fg can be a matlab format string, a<br>
html hex color string, an rgb unit tuple, or a float between 0<br>
and 1. In the latter case, grayscale is used.<br>
<br>
The :class:`<a href="matplotlib.backend_bases.html#GraphicsContextBase">GraphicsContextBase</a>` converts colors to rgb<br>
internally. If you know the color is rgb already, you can set<br>
``isRGB=True`` to avoid the performace hit of the conversion</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-set_graylevel"><strong>set_graylevel</strong></a>(self, frac)</dt><dd><tt>Set the foreground color to be a gray level with *frac*</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-set_hatch"><strong>set_hatch</strong></a>(self, hatch)</dt><dd><tt>Sets the hatch style for filling</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-set_joinstyle"><strong>set_joinstyle</strong></a>(self, js)</dt><dd><tt>Set the join style to be one of ('miter', 'round', 'bevel')</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-set_linestyle"><strong>set_linestyle</strong></a>(self, style)</dt><dd><tt>Set the linestyle to be one of ('solid', 'dashed', 'dashdot',<br>
'dotted').</tt></dd></dl>
<dl><dt><a name="GraphicsContextPS-set_linewidth"><strong>set_linewidth</strong></a>(self, w)</dt><dd><tt>Set the linewidth in points</tt></dd></dl>
<hr>
Data and other attributes inherited from <a href="matplotlib.backend_bases.html#GraphicsContextBase">matplotlib.backend_bases.GraphicsContextBase</a>:<br>
<dl><dt><strong>dashd</strong> = {'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)}</dl>
</td></tr></table> <p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#ffc8d8">
<td colspan=3 valign=bottom> <br>
<font color="#000000" face="helvetica, arial"><a name="RendererPS">class <strong>RendererPS</strong></a>(<a href="matplotlib.backend_bases.html#RendererBase">matplotlib.backend_bases.RendererBase</a>)</font></td></tr>
<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
<td colspan=2><tt>The renderer handles all the drawing primitives using a graphics<br>
context instance that controls the colors/styles.<br> </tt></td></tr>
<tr><td> </td>
<td width="100%">Methods defined here:<br>
<dl><dt><a name="RendererPS-__init__"><strong>__init__</strong></a>(self, width, height, pswriter, imagedpi<font color="#909090">=72</font>)</dt><dd><tt>Although postscript itself is dpi independent, we need to<br>
imform the image code about a requested dpi to generate high<br>
res images and them scale them before embeddin them</tt></dd></dl>
<dl><dt><a name="RendererPS-draw_image"><strong>draw_image</strong></a>(self, x, y, im, bbox, clippath<font color="#909090">=None</font>, clippath_trans<font color="#909090">=None</font>)</dt><dd><tt>Draw the Image instance into the current axes; x is the<br>
distance in pixels from the left hand side of the canvas and y<br>
is the distance from bottom<br>
<br>
bbox is a matplotlib.transforms.BBox instance for clipping, or<br>
None</tt></dd></dl>
<dl><dt><a name="RendererPS-draw_markers"><strong>draw_markers</strong></a>(self, gc, marker_path, marker_trans, path, trans, rgbFace<font color="#909090">=None</font>)</dt><dd><tt>Draw the markers defined by path at each of the positions in x<br>
and y. path coordinates are points, x and y coords will be<br>
transformed by the transform</tt></dd></dl>
<dl><dt><a name="RendererPS-draw_mathtext"><strong>draw_mathtext</strong></a>(self, gc, x, y, s, prop, angle)</dt><dd><tt>Draw the math text using matplotlib.mathtext</tt></dd></dl>
<dl><dt><a name="RendererPS-draw_path"><strong>draw_path</strong></a>(self, gc, path, transform, rgbFace<font color="#909090">=None</font>)</dt><dd><tt>Draws a Path instance using the given affine transform.</tt></dd></dl>
<dl><dt><a name="RendererPS-draw_path_collection"><strong>draw_path_collection</strong></a>(self, master_transform, cliprect, clippath, clippath_trans, paths, all_transforms, offsets, offsetTrans, facecolors, edgecolors, linewidths, linestyles, antialiaseds)</dt></dl>
<dl><dt><a name="RendererPS-draw_tex"><strong>draw_tex</strong></a>(self, gc, x, y, s, prop, angle, ismath<font color="#909090">='TeX!'</font>)</dt><dd><tt>draw a Text instance</tt></dd></dl>
<dl><dt><a name="RendererPS-draw_text"><strong>draw_text</strong></a>(self, gc, x, y, s, prop, angle, ismath)</dt><dd><tt>draw a Text instance</tt></dd></dl>
<dl><dt><a name="RendererPS-draw_unicode"><strong>draw_unicode</strong></a>(self, gc, x, y, s, prop, angle)</dt><dd><tt>draw a unicode string. ps doesn't have unicode support, so<br>
we have to do this the hard way</tt></dd></dl>
<dl><dt><a name="RendererPS-flipy"><strong>flipy</strong></a>(self)</dt><dd><tt>return true if small y numbers are top for renderer</tt></dd></dl>
<dl><dt><a name="RendererPS-get_canvas_width_height"><strong>get_canvas_width_height</strong></a>(self)</dt><dd><tt>return the canvas width and height in display coords</tt></dd></dl>
<dl><dt><a name="RendererPS-get_image_magnification"><strong>get_image_magnification</strong></a>(self)</dt><dd><tt>Get the factor by which to magnify images passed to draw_image.<br>
Allows a backend to have images at a different resolution to other<br>
artists.</tt></dd></dl>
<dl><dt><a name="RendererPS-get_text_width_height_descent"><strong>get_text_width_height_descent</strong></a>(self, s, prop, ismath)</dt><dd><tt>get the width and height in display coords of the string s<br>
with FontPropertry prop</tt></dd></dl>
<dl><dt><a name="RendererPS-merge_used_characters"><strong>merge_used_characters</strong></a>(self, other)</dt></dl>
<dl><dt><a name="RendererPS-new_gc"><strong>new_gc</strong></a>(self)</dt></dl>
<dl><dt><a name="RendererPS-set_color"><strong>set_color</strong></a>(self, r, g, b, store<font color="#909090">=1</font>)</dt></dl>
<dl><dt><a name="RendererPS-set_font"><strong>set_font</strong></a>(self, fontname, fontsize, store<font color="#909090">=1</font>)</dt></dl>
<dl><dt><a name="RendererPS-set_hatch"><strong>set_hatch</strong></a>(self, hatch)</dt><dd><tt>hatch can be one of:<br>
/ - diagonal hatching<br>
\ - back diagonal<br>
| - vertical<br>
- - horizontal<br>
+ - crossed<br>
X - crossed diagonal<br>
<br>
letters can be combined, in which case all the specified<br>
hatchings are done<br>
<br>
if same letter repeats, it increases the density of hatching<br>
in that direction</tt></dd></dl>
<dl><dt><a name="RendererPS-set_linecap"><strong>set_linecap</strong></a>(self, linecap, store<font color="#909090">=1</font>)</dt></dl>
<dl><dt><a name="RendererPS-set_linedash"><strong>set_linedash</strong></a>(self, offset, seq, store<font color="#909090">=1</font>)</dt></dl>
<dl><dt><a name="RendererPS-set_linejoin"><strong>set_linejoin</strong></a>(self, linejoin, store<font color="#909090">=1</font>)</dt></dl>
<dl><dt><a name="RendererPS-set_linewidth"><strong>set_linewidth</strong></a>(self, linewidth, store<font color="#909090">=1</font>)</dt></dl>
<dl><dt><a name="RendererPS-track_characters"><strong>track_characters</strong></a>(self, font, s)</dt><dd><tt>Keeps track of which characters are required from<br>
each font.</tt></dd></dl>
<hr>
Data and other attributes defined here:<br>
<dl><dt><strong>afmfontd</strong> = {}</dl>
<dl><dt><strong>fontd</strong> = {}</dl>
<hr>
Methods inherited from <a href="matplotlib.backend_bases.html#RendererBase">matplotlib.backend_bases.RendererBase</a>:<br>
<dl><dt><a name="RendererPS-close_group"><strong>close_group</strong></a>(self, s)</dt><dd><tt>Close a grouping element with label *s*<br>
Is only currently used by :mod:`~matplotlib.backends.backend_svg`</tt></dd></dl>
<dl><dt><a name="RendererPS-draw_quad_mesh"><strong>draw_quad_mesh</strong></a>(self, master_transform, cliprect, clippath, clippath_trans, meshWidth, meshHeight, coordinates, offsets, offsetTrans, facecolors, antialiased, showedges)</dt><dd><tt>This provides a fallback implementation of<br>
:meth:`draw_quad_mesh` that generates paths and then calls<br>
:meth:`draw_path_collection`.</tt></dd></dl>
<dl><dt><a name="RendererPS-get_texmanager"><strong>get_texmanager</strong></a>(self)</dt><dd><tt>return the :class:`matplotlib.texmanager.TexManager` instance</tt></dd></dl>
<dl><dt><a name="RendererPS-open_group"><strong>open_group</strong></a>(self, s)</dt><dd><tt>Open a grouping element with label *s*. Is only currently used by<br>
:mod:`~matplotlib.backends.backend_svg`</tt></dd></dl>
<dl><dt><a name="RendererPS-option_image_nocomposite"><strong>option_image_nocomposite</strong></a>(self)</dt><dd><tt>overwrite this method for renderers that do not necessarily<br>
want to rescale and composite raster images. (like SVG)</tt></dd></dl>
<dl><dt><a name="RendererPS-points_to_pixels"><strong>points_to_pixels</strong></a>(self, points)</dt><dd><tt>Convert points to display units<br>
<br>
*points*<br>
a float or a numpy array of float<br>
<br>
return points converted to pixels<br>
<br>
You need to override this function (unless your backend<br>
doesn't have a dpi, eg, postscript or svg). Some imaging<br>
systems assume some value for pixels per inch::<br>
<br>
points to pixels = points * pixels_per_inch/72.0 * dpi/72.0</tt></dd></dl>
<dl><dt><a name="RendererPS-start_rasterizing"><strong>start_rasterizing</strong></a>(self)</dt></dl>
<dl><dt><a name="RendererPS-stop_rasterizing"><strong>stop_rasterizing</strong></a>(self)</dt></dl>
<dl><dt><a name="RendererPS-strip_math"><strong>strip_math</strong></a>(self, s)</dt></dl>
</td></tr></table></td></tr></table><p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#eeaa77">
<td colspan=3 valign=bottom> <br>
<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
<td width="100%"><dl><dt><a name="-FT2Font"><strong>FT2Font</strong></a>(...)</dt><dd><tt>FT2Font</tt></dd></dl>
<dl><dt><a name="-StringIO"><strong>StringIO</strong></a>(...)</dt><dd><tt><a href="#-StringIO">StringIO</a>([s]) -- Return a StringIO-like stream for reading or writing</tt></dd></dl>
<dl><dt><a name="-convert_psfrags"><strong>convert_psfrags</strong></a>(tmpfile, psfrags, font_preamble, custom_preamble, paperWidth, paperHeight, orientation)</dt><dd><tt>When we want to use the LaTeX backend with postscript, we write PSFrag tags<br>
to a temporary postscript file, each one marking a position for LaTeX to<br>
render some text. convert_psfrags generates a LaTeX document containing the<br>
commands to convert those tags to text. LaTeX/dvips produces the postscript<br>
file that includes the actual text.</tt></dd></dl>
<dl><dt><a name="-convert_ttf_to_ps"><strong>convert_ttf_to_ps</strong></a>(...)</dt><dd><tt><a href="#-convert_ttf_to_ps">convert_ttf_to_ps</a>(filename, output, fonttype, glyph_ids)<br>
<br>
Converts the Truetype font into a Type 3 or Type 42 Postscript font, optionally subsetting the font to only the desired set of characters.<br>
<br>
filename is the path to a TTF font file.<br>
output is a Python file-like object with a write method that the Postscript font data will be written to.<br>
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.<br>
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.</tt></dd></dl>
<dl><dt><a name="-get_bbox"><strong>get_bbox</strong></a>(tmpfile, bbox)</dt><dd><tt>Use ghostscript's bbox device to find the center of the bounding box. Return<br>
an appropriately sized bbox centered around that point. A bit of a hack.</tt></dd></dl>
<dl><dt><a name="-gs_distill"><strong>gs_distill</strong></a>(tmpfile, eps<font color="#909090">=False</font>, ptype<font color="#909090">='letter'</font>, bbox<font color="#909090">=None</font>)</dt><dd><tt>Use ghostscript's pswrite or epswrite device to distill a file.<br>
This yields smaller files without illegal encapsulated postscript<br>
operators. The output is low-level, converting text to outlines.</tt></dd></dl>
<dl><dt><a name="-md5"><strong>md5</strong></a> = openssl_md5(...)</dt><dd><tt>Returns a md5 hash object; optionally initialized with a string</tt></dd></dl>
<dl><dt><a name="-new_figure_manager"><strong>new_figure_manager</strong></a>(num, *args, **kwargs)</dt></dl>
<dl><dt><a name="-pstoeps"><strong>pstoeps</strong></a>(tmpfile, bbox)</dt><dd><tt>Convert the postscript to encapsulated postscript.</tt></dd></dl>
<dl><dt><a name="-quote_ps_string"><strong>quote_ps_string</strong></a>(s)</dt><dd><tt>Quote dangerous characters of S for use in a PostScript string constant.</tt></dd></dl>
<dl><dt><a name="-seq_allequal"><strong>seq_allequal</strong></a>(seq1, seq2)</dt><dd><tt>seq1 and seq2 are either None or sequences or numerix arrays<br>
Return True if both are None or both are seqs with identical<br>
elements</tt></dd></dl>
<dl><dt><a name="-xpdf_distill"><strong>xpdf_distill</strong></a>(tmpfile, eps<font color="#909090">=False</font>, ptype<font color="#909090">='letter'</font>, bbox<font color="#909090">=None</font>)</dt><dd><tt>Use ghostscript's ps2pdf and xpdf's/poppler's pdftops to distill a file.<br>
This yields smaller files without illegal encapsulated postscript<br>
operators. This distiller is preferred, generating high-level postscript<br>
output that treats text as text.</tt></dd></dl>
</td></tr></table><p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#55aa55">
<td colspan=3 valign=bottom> <br>
<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
<td width="100%"><strong>KERNING_DEFAULT</strong> = 0<br>
<strong>LOAD_NO_HINTING</strong> = 2L<br>
<strong>__version__</strong> = '0.98.3'<br>
<strong>backend_version</strong> = 'Level II'<br>
<strong>cmd_split</strong> = ';'<br>
<strong>debugPS</strong> = 0<br>
<strong>division</strong> = _Feature((2, 2, 0, 'alpha', 2), (3, 0, 0, 'alpha', 0), 8192)<br>
<strong>get_realpath_and_stat</strong> = <matplotlib.cbook.GetRealpathAndStat instance at 0xda70e0><br>
<strong>papersize</strong> = {'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), ...}<br>
<strong>psDefs</strong> = ['/m { moveto } bind def', '/l { lineto } bind def', '/r { rlineto } bind def', '/c { curveto } bind def', '/cl { closepath } bind def', '/box {<font color="#c040c0">\n</font> m<font color="#c040c0">\n</font> 1 index 0 r<font color="#c040c0">\n</font> 0 exch r<font color="#c040c0">\n</font> neg 0 r<font color="#c040c0">\n</font> cl<font color="#c040c0">\n</font> } bind def', '/clipbox {<font color="#c040c0">\n</font> box<font color="#c040c0">\n</font> clip<font color="#c040c0">\n</font> newpath<font color="#c040c0">\n</font> } bind def']<br>
<strong>rcParams</strong> = {'figure.subplot.right': 0.90000000000000002, 'm...persize': 'letter', 'svg.embed_char_paths': True}<br>
<strong>uni2type1</strong> = {32: 'space', 33: 'exclam', 34: 'quotedbl', 35: 'numbersign', 36: 'dollar', 37: 'percent', 38: 'ampersand', 39: 'quotesingle', 40: 'parenleft', 41: 'parenright', ...}<br>
<strong>verbose</strong> = <matplotlib.Verbose instance at 0xdce248></td></tr></table>
@footer@