Jc @ s d Z d d k l Z d d k Z d d k Z d d k Z d d k Z d d k i Z d d k
i Z d d k i
Z
d d k i Z d d k i Z d d k l Z d d k l Z l Z l Z d d k Z d d k i Z d f d YZ d f d YZ d
f d YZ d e f d
YZ d e f d YZ d e f d YZ d e f d YZ d e f d YZ! d e f d YZ" d e f d YZ# d f d YZ$ d f d YZ% d f d YZ& e& Z' d f d! YZ( d S(" s
Abstract base classes define the primitives that renderers and
graphics contexts must implement to serve as a matplotlib backend
:class:`RendererBase`
An abstract base class to handle drawing/rendering operations.
:class:`FigureCanvasBase`
The abstraction layer that separates the
:class:`matplotlib.figure.Figure` from the backend specific
details like a user interface drawing area
:class:`GraphicsContextBase`
An abstract base class that provides color, line styles, etc...
:class:`Event`
The base class for all of the matplotlib event
handling. Derived classes suh as :class:`KeyEvent` and
:class:`MouseEvent` store the meta data like keys and buttons
pressed, x and y locations in pixel and
:class:`~matplotlib.axes.Axes` coordinates.
i( t divisionN( t rcParams( t Bboxt TransformedBboxt Affine2Dt RendererBasec B s e Z d Z d Z d d Z d Z d d Z d d Z d Z d Z
d Z d Z d
Z
d d d Z d Z d
d Z e d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z RS( s An abstract base class to handle drawing/rendering operations.
The following methods *must* be implemented in the backend:
* :meth:`draw_path`
* :meth:`draw_image`
* :meth:`draw_text`
* :meth:`get_text_width_height_descent`
The following methods *should* be implemented in the backend for
optimization reasons:
* :meth:`draw_markers`
* :meth:`draw_path_collection`
* :meth:`draw_quad_mesh`
c C s
d | _ d S( N( t Nonet _texmanager( t self( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt __init__: s c C s d S( s
Open a grouping element with label *s*. If *gid* is given, use
*gid* as the id of the group. Is only currently used by
:mod:`~matplotlib.backends.backend_svg`.
N( ( R t st gid( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt
open_group= s c C s d S( s
Close a grouping element with label *s*
Is only currently used by :mod:`~matplotlib.backends.backend_svg`
N( ( R R
( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt close_groupE s c C s
t d S( sk
Draws a :class:`~matplotlib.path.Path` instance using the
given affine transform.
N( t NotImplementedError( R t gct patht transformt rgbFace( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt draw_pathL s c C sw xp | i | d t D]Y \ } } t | o@ | d \ } }
| i | | | t i i | |
| q q Wd S( s
Draws a marker at each of the vertices in path. This includes
all vertices, including control points on curves. To avoid
that behavior, those vertices should be removed before calling
this function.
*gc*
the :class:`GraphicsContextBase` instance
*marker_trans*
is an affine transform applied to the marker.
*trans*
is an affine transform applied to the path.
This provides a fallback implementation of draw_markers that
makes multiple calls to :meth:`draw_path`. Some backends may
want to override this method in order to draw the marker only
once and reuse it multiple times.
t simplifyiN( t
iter_segmentst Falset lenR t
transformsR t translate( R R t marker_patht marker_transR t transR t verticest codest xt y( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt draw_markersS s
c C s g } x6 | i | | | D] \ } } | i | | f q Wx | i | | | | | | | |
| | |
| D]X \ } } } } } | \ } } t i | i i | | } | i | | | | qp Wd S( s
Draws a collection of paths, selecting drawing properties from
the lists *facecolors*, *edgecolors*, *linewidths*,
*linestyles* and *antialiaseds*. *offsets* is a list of
offsets to apply to each of the paths. The offsets in
*offsets* are first transformed by *offsetTrans* before
being applied.
This provides a fallback implementation of
:meth:`draw_path_collection` that makes multiple calls to
draw_path. Some backends may want to override this in order
to render each set of path data only once, and then reference
that path multiple times with the different offsets, colors,
styles etc. The generator methods
:meth:`_iter_collection_raw_paths` and
:meth:`_iter_collection` are provided to help with (and
standardize) the implementation across backends. It is highly
recommended to use those generators, so that changes to the
behavior of :meth:`draw_path_collection` can be made globally.
N( t _iter_collection_raw_pathst appendt _iter_collectionR R t
get_matrixR R ( R t master_transformt cliprectt clippatht clippath_transt pathst all_transformst offsetst offsetTranst
facecolorst
edgecolorst
linewidthst
linestylest antialiasedst urlst path_idsR R t xot yot path_idR R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt draw_path_collectiono s
!c
C s d d k l }
|
i | | | } | o@ t i d d d d g g t i } t i d g t i } n |
} t i d g t i } | i | | | | | g | | |
| | g | g d g S( s
This provides a fallback implementation of
:meth:`draw_quad_mesh` that generates paths and then calls
:meth:`draw_path_collection`.
i( t QuadMeshg g ?N( t matplotlib.collectionsR9 t convert_mesh_to_pathst npt arrayt float_R8 R ( R R& R' R( R) t meshWidtht
meshHeightt coordinatesR, R- R. t antialiasedt showedgesR9 R* R/ R0 ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt draw_quad_mesh s $ c
c s t | } t | } t | | } | d j o d St i } xJ t | D]< } | | | } | o | | | } n | | | f VqR Wd S( sI
This is a helper method (along with :meth:`_iter_collection`) to make
it easier to write a space-efficent :meth:`draw_path_collection`
implementation in a backend.
This method yields all of the base path/transform
combinations, given a master transform, a list of paths and
list of transforms.
The arguments should be exactly what is passed in to
:meth:`draw_path_collection`.
The backend should take each yielded path and transform and
create an object that can be referenced (reused) later.
i N( R t maxR t IdentityTransformt xrange(
R R& R* R+ t Npathst Ntransformst NR t iR ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR" s
c
c s t | }
t | } t |
| } t | } t | } t | } t |
} t | } t | } | d j o
| d j p
|
d j o d S| o | i | } n | i } | i | | d j o# t i | | } | i | n | d j o
d } n | d j o | i d n d \ } } xBt
| D]4} | | |
} | o | | | \ } } n | o | | | } n | oY | i | | | | o | i | | | n | o | i |
| | qn | d j o2 t | d j o | i
| d | d } n | i | | | | o | i | | | n | | | | | f VqLW| i d S( s
This is a helper method (along with
:meth:`_iter_collection_raw_paths`) to make it easier to write
a space-efficent :meth:`draw_path_collection` implementation in a
backend.
This method yields all of the path, offset and graphics
context combinations to draw the path collection. The caller
should already have looped over the results of
:meth:`_iter_collection_raw_paths` to draw this collection.
The arguments should be the same as that passed into
:meth:`draw_path_collection`, with the exception of
*path_ids*, which is a list of arbitrary objects that the
backend will use to reference one of the paths created in the
:meth:`_iter_collection_raw_paths` stage.
Each yielded result is of the form::
xo, yo, path_id, gc, rgbFace
where *xo*, *yo* is an offset; *path_id* is one of the elements of
*path_ids*; *gc* is a graphics context and *rgbFace* is a color to
use for filling the path.
i Ng i ii ( i i ( R RE R t new_gct set_clip_rectangleR R t TransformedPatht
set_clip_patht
set_linewidthRG t set_foregroundt
set_dashest set_alphat set_antialiasedt set_urlt restore( R R4 R' R( R) R, R- R. R/ R0 R1 R2 R3 RH t NoffsetsRJ t Nfacecolorst Nedgecolorst Nlinewidthst Nlinestylest Naat Nurlst toffsetsR R R5 R6 RK R7 ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR$ sX '
c C s d S( s
Get the factor by which to magnify images passed to :meth:`draw_image`.
Allows a backend to have images at a different resolution to other
artists.
g ?( ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt get_image_magnification s c C s
t d S( s
Draw the image instance into the current axes;
*x*
is the distance in pixels from the left hand side of the canvas.
*y*
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
*im*
the :class:`matplotlib._image.Image` instance
*bbox*
a :class:`matplotlib.transforms.Bbox` instance for clipping, or
None
N( R ( R R R t imt bboxR( R) ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt
draw_image" s c C s t S( s
overwrite this method for renderers that do not necessarily
want to rescale and composite raster images. (like SVG)
( R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt option_image_nocomposite8 s s TeX!c C s
t d S( N( R ( R R R R R
t propt anglet ismath( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt draw_tex? s c C s
t d S( sT
Draw the text instance
*gc*
the :class:`GraphicsContextBase` instance
*x*
the x location of the text in display coords
*y*
the y location of the text in display coords
*s*
a :class:`matplotlib.text.Text` instance
*prop*
a :class:`matplotlib.font_manager.FontProperties` instance
*angle*
the rotation angle in degrees
**backend implementers note**
When you are trying to determine if you have gotten your bounding box
right (which is what enables the text layout/alignment to work
properly), it helps to change the line in text.py::
if 0: bbox_artist(self, renderer)
to if 1, and then the actual bounding box will be blotted along with
your text.
N( R ( R R R R R
Rd Re Rf ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt draw_textB s !c C s t S( s
Return true if y small numbers are top for renderer Is used
for drawing text (:mod:`matplotlib.text`) and images
(:mod:`matplotlib.image`) only
( t True( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt flipye s c C s d S( s4 return the canvas width and height in display coordsi ( i i ( ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt get_canvas_width_heightm s c C s7 | i d j o d d k l } | | _ n | i S( sO
return the :class:`matplotlib.texmanager.TexManager` instance
i( t
TexManagerN( R R t matplotlib.texmanagerRl ( R Rl ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt get_texmanagerq s c C s
t d S( s
get the width and height, and the offset from the bottom to the
baseline (descent), in display coords of the string s with
:class:`~matplotlib.font_manager.FontProperties` prop
N( R ( R R
Rd Rf ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt get_text_width_height_descentz s c C s t S( sF
Return an instance of a :class:`GraphicsContextBase`
( t GraphicsContextBase( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRL s c C s | S( s
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
( ( R t points( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt points_to_pixels s c C s
t i | S( N( t cbookt
strip_math( R R
( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRt s c C s d S( N( ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt start_rasterizing s c C s d S( N( ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt stop_rasterizing s N( t __name__t
__module__t __doc__R R R R
R R! R8 RD R" R$ R_ Rb Rc Rg R Rh Rj Rk Rn Ro RL Rr Rt Ru Rv ( ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR ) s0 % O # Rp c B s_ e Z d Z h d* d 6d d+ f d 6d d, f d 6d d- f d 6Z d
Z d Z d Z d
Z d Z d Z
d Z d Z d Z
d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z e d Z d Z d! Z d" Z d# Z d$ Z d% Z! d& Z" d' Z# d d( Z$ RS(. sI
An abstract base class that provides color, line styles, etc...
t solidi g @t dashedg @g @g ?t dashdott dottedc C sy d | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _ d | _
d | _ d | _ d | _
d S( Ng ?i t buttt roundRz g ( NN( g g g ( t _alphat _antialiasedt _capstyleR t _cliprectt _clippatht _dashest
_joinstylet
_linestylet
_linewidtht _rgbt _hatcht _urlt _snap( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s c C s | i | _ | i | _ | i | _ | i | _ | i | _ | i | _ | i | _ | i | _ | i | _ | i | _ | i
| _
| i | _ | i | _ d S( s Copy properties from gc to selfN(
R R R R R R R R R R R R R ( R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt copy_properties s c C s d S( s
Restore the graphics context from the stack - needed only
for backends that save graphics contexts on a stack
N( ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRV s c C s | i S( sb
Return the alpha value used for blending - not supported on
all backends
( R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt get_alpha s c C s | i S( s@ Return true if the object should try to do antialiased rendering( R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt get_antialiased s c C s | i S( sT
Return the capstyle as a string in ('butt', 'round', 'projecting')
( R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt get_capstyle s c C s | i S( s^
Return the clip rectangle as a :class:`~matplotlib.transforms.Bbox` instance
( R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt get_clip_rectangle s c C s" | i d j o | i i Sd S( s
Return the clip path in the form (path, transform), where path
is a :class:`~matplotlib.path.Path` instance, and transform is
an affine transform to apply to the path before clipping.
N( NN( R R t get_transformed_path_and_affine( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt
get_clip_path s c C s | i S( sN
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
( R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt
get_dashes s
c C s | i S( sR
Return the line join style as one of ('miter', 'round', 'bevel')
( R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt
get_joinstyle s c C s | i S( s`
Return the linestyle: one of ('solid', 'dashed', 'dashdot',
'dotted').
( R ( R t style( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt
get_linestyle s c C s | i S( s=
Return the line width in points as a scalar
( R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt
get_linewidth s c C s | i S( s
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
( R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt get_rgb s c C s | i S( s=
returns a url if one is set, None otherwise
( R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt get_url s c C s | i S( s
returns the snap setting which may be:
* True: snap vertices to the nearest pixel center
* False: leave vertices as-is
* None: (auto) If the path contains only rectilinear line
segments, round to the nearest pixel center
( R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt get_snap& s c C s
| | _ d S( s_
Set the alpha value used for blending - not supported on
all backends
N( R ( R t alpha( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRS 3 s c C s! | o
d | _ n
d | _ d S( sK
True if object should be drawn with antialiased rendering
i i N( R ( R t b( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRT : s
c C s. | d j o
| | _ n t d | d S( sQ
Set the capstyle as a string in ('butt', 'round', 'projecting')
R~ R t
projectings! Unrecognized cap style. Found %sN( s butts roundR ( R t
ValueError( R t cs( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt set_capstyleC s
c C s
| | _ d S( sT
Set the clip rectangle with sequence (left, bottom, width, height)
N( R ( R t rectangle( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRM L s c C s
| | _ d S( s
Set the clip path and transformation. Path should be a
:class:`~matplotlib.transforms.TransformedPath` instance.
N( R ( R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRO R s c C s | | f | _ d S( s
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
N( R ( R t dash_offsett dash_list( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRR Z s c C s- | o
| | _ n t i i | | _ d S( s
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 :class:`GraphicsContextBase` converts colors to rgb
internally. If you know the color is rgb already, you can set
``isRGB=True`` to avoid the performace hit of the conversion
N( R t colorst colorConvertert to_rgba( R t fgt isRGB( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRQ g s
c C s | | | f | _ d S( sI
Set the foreground color to be a gray level with *frac*
N( R ( R t frac( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt
set_graylevelv s c C s. | d j o
| | _ n t d | d S( sM
Set the join style to be one of ('miter', 'round', 'bevel')
t miterR t bevels" Unrecognized join style. Found %sN( R s roundR ( R R ( R t js( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt
set_joinstyle| s
c C s
| | _ d S( s-
Set the linewidth in points
N( R ( R t w( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRP s c C sN y | i | \ } } Wn t d | n X| | _ | i | | d S( sb
Set the linestyle to be one of ('solid', 'dashed', 'dashdot',
'dotted').
s Unrecognized linestyle: %sN( t dashdR R RR ( R R t offsett dashes( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt
set_linestyle s c C s
| | _ d S( s?
Sets the url for links in compatible backends
N( R ( R t url( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRU s c C s
| | _ d S( s
Sets the snap setting which may be:
* True: snap vertices to the nearest pixel center
* False: leave vertices as-is
* None: (auto) If the path contains only rectilinear line
segments, round to the nearest pixel center
N( R ( R t snap( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt set_snap s c C s
| | _ d S( s2
Sets the hatch style for filling
N( R ( R t hatch( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt set_hatch s c C s | i S( s.
Gets the current hatch style
( R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt get_hatch s c C s+ | i d j o d St i i | i | S( s7
Returns a Path for the current hatch.
N( R R R t PathR ( R t density( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt get_hatch_path s N( NN( g @g @( g @g @g ?g @( g ?g @(% Rw Rx Ry R R R R RV R R R R R R R R R R R R RS RT R RM RO RR R RQ R R RP R RU R R R R ( ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRp sJ
t Eventc B s e Z d Z d d Z RS( su
A matplotlib event. Attach additional attributes as defined in
:meth:`FigureCanvasBase.mpl_connect`. The following attributes
are defined and shown with their default values
*name*
the event name
*canvas*
the FigureCanvas instance generating the event
*guiEvent*
the GUI event that triggered the matplotlib event
c C s | | _ | | _ | | _ d S( N( t namet canvast guiEvent( R R R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s N( Rw Rx Ry R R ( ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s t IdleEventc B s e Z d Z RS( sc
An event triggered by the GUI backend when it is idle -- useful
for passive animation
( Rw Rx Ry ( ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s t DrawEventc B s e Z d Z d Z RS( s
An event triggered by a draw operation on the canvas
In addition to the :class:`Event` attributes, the following event attributes are defined:
*renderer*
the :class:`RendererBase` instance for the draw event
c C s t i | | | | | _ d S( N( R R t renderer( R R R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s ( Rw Rx Ry R ( ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s t ResizeEventc B s e Z d Z d Z RS( s
An event triggered by a canvas resize
In addition to the :class:`Event` attributes, the following event attributes are defined:
*width*
width of the canvas in pixels
*height*
height of the canvas in pixels
c C s/ t i | | | | i \ | _ | _ d S( N( R R t get_width_heightt widtht height( R R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s ( Rw Rx Ry R ( ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s t
LocationEventc B sG e Z d Z d Z d Z d Z d Z d Z d Z d d Z
d Z RS( s
A event that has a screen location
The following additional attributes are defined and shown with
their default values
In addition to the :class:`Event` attributes, the following event attributes are defined:
*x*
x position - pixels from left of canvas
*y*
y position - pixels from bottom of canvas
*inaxes*
the :class:`~matplotlib.axes.Axes` instance if mouse is over axes
*xdata*
x coord of mouse in data coords
*ydata*
y coord of mouse in data coords
c C s t i | | | d | | | _ | | _ | d j p
| d j o d | _ | i d Sg } | i i i D]! } | i
| o | | qt qt ~ } t | d j o d | _ | i d St | d j o' d } | i | | d | _ n | d | _ y+ | i i
i i | | f \ }
} Wn% t j
o d | _ d | _ n X|
| _ | | _ | i d S( s?
*x*, *y* in figure coords, 0,0 = bottom, left
R Ni i c S s t | i | i S( ( t cmpt zorder( t _xt _y( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt 4 s i( R R R R R t inaxest _update_enter_leaveR t figuret get_axest in_axesR t sortt transDatat invertedt transform_pointR t xdatat ydata( R R R R R R t _[1]t at axes_listt axCmpR R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s2
A
+ c C s t i d j ox t i } | i | i j oX | i d j o | i i i d | n | i d j o | i i i d | q q n+ | i d j o | i i i d | n | t _ d S( s* process the figure/axes enter leave eventst axes_leave_eventt axes_enter_eventN( R t lasteventR R R t callbackst process( R t last( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR E s "N( Rw Rx Ry R R R R R R R R R ( ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s )t
MouseEventc B sM e Z d Z d Z d Z d Z d Z d Z d Z d Z
d d d d d Z RS( s
A mouse event ('button_press_event', 'button_release_event', 'scroll_event',
'motion_notify_event').
In addition to the :class:`Event` and :class:`LocationEvent`
attributes, the following attributes are defined:
*button*
button pressed None, 1, 2, 3, 'up', 'down' (up and down are used for scroll events)
*key*
the key pressed: None, chr(range(255), 'shift', 'win', or 'control'
*step*
number of scroll steps (positive for 'up', negative for 'down')
Example usage::
def on_press(event):
print 'you pressed', event.button, event.xdata, event.ydata
cid = fig.canvas.mpl_connect('button_press_event', on_press)
i c C s> t i | | | | | d | | | _ | | _ | | _ d S( sn
x, y in figure coords, 0,0 = bottom, left
button pressed None, 1, 2, 3, 'up', 'down'
R N( R R t buttont keyt step( R R R R R R R R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR } s N( Rw Rx Ry R R R R R R R R R ( ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR [ s t PickEventc B s e Z d Z d d Z RS( sw
a pick event, fired when the user picks a location on the canvas
sufficiently close to an artist.
Attrs: all the :class:`Event` attributes plus
*mouseevent*
the :class:`MouseEvent` that generated the pick
*artist*
the :class:`~matplotlib.artist.Artist` picked
other
extra class dependent attrs -- eg a
:class:`~matplotlib.lines.Line2D` pick may define different
extra attributes than a
:class:`~matplotlib.collections.PatchCollection` pick event
Example usage::
line, = ax.plot(rand(100), 'o', picker=5) # 5 points tolerance
def on_pick(event):
thisline = event.artist
xdata, ydata = thisline.get_data()
ind = event.ind
print 'on pick line:', zip(xdata[ind], ydata[ind])
cid = fig.canvas.mpl_connect('pick_event', on_pick)
c K s< t i | | | | | | _ | | _ | i i | d S( N( R R t
mouseeventt artistt __dict__t update( R R R R R R t kwargs( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s N( Rw Rx Ry R R ( ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s t KeyEventc B s e Z d Z d d d d Z RS( sj
A key event (key press, key release).
Attach additional attributes as defined in
:meth:`FigureCanvasBase.mpl_connect`.
In addition to the :class:`Event` and :class:`LocationEvent`
attributes, the following attributes are defined:
*key*
the key pressed: None, chr(range(255), shift, win, or control
This interface may change slightly when better support for
modifier keys is included.
Example usage::
def on_key(event):
print 'you pressed', event.key, event.xdata, event.ydata
cid = fig.canvas.mpl_connect('key_press_event', on_key)
i c C s, t i | | | | | d | | | _ d S( NR ( R R R ( R R R R R R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s N( Rw Rx Ry R R ( ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s t FigureCanvasBasec B s@ e Z d Z d d d d d d d d d d
d d d
d g Z d Z d Z d Z d Z dM d Z d Z
d Z d Z dM d Z
dM d Z d Z dM d Z dM d Z dM d Z dM d Z dM d Z dM d Z dM d Z d! Z d" Z d# Z d$ Z h d% d& 6d' d( 6d) d* 6d+ d, 6d- d. 6d/ d0 6d/ d1 6d2 d3 6d2 d4 6Z d5 Z d6 Z d7 Z d8 Z d9 Z d: Z! e! Z" Z# d; Z$ d< Z% d= Z& d> Z' dM d? d? d@ dM dA Z( dB Z) dC Z* dD Z+ dE Z, dF Z- dG Z. dH Z/ dI Z0 dJ dK Z1 dL Z2 RS(N s
The canvas the figure renders into.
Public attributes
*figure*
A :class:`matplotlib.figure.Figure` instance
t resize_eventt
draw_eventt key_press_eventt key_release_eventt button_press_eventt button_release_eventt scroll_eventt motion_notify_eventt
pick_eventt
idle_eventt figure_enter_eventt figure_leave_eventR R c C s | i | | | _ t i | i | _ t i | _ d | _
d | _ d \ | _ | _
| i d | i | _ | i d | i | _ t o | i d | i n d S( NR R R ( NN( t
set_canvasR Rs t CallbackRegistryt eventsR t widgetst LockDrawt
widgetlockR t _buttont _keyt _lastxt _lastyt mpl_connectt pickt button_pick_idt scroll_pick_idR t onHilite( R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s
c C s d } | | i i | } d } | o | d } n xl | od d G| GH| i o | i Pn d } x, | D]$ } | | i j o | } Pqx qx W| } q? Wd S( s
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)
c S sY g } | D] } | | i | f q ~ } | i g } | D] \ } } | | q? ~ S( N( R R ( t artistsR t ht Lt _[2]R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt sort_artists s *
it RemovingN( R t hitlistR t removet draw_idlet get_children( R t evR t underR t parentt p( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt onRemove s$
c C s t | d p t | _ n | i i | } g } | D]! } | | i j o | | q= q= ~ } g } | i D] } | | j o | | qu qu ~ } x | D]| } t | d o | i | i | nE t | d o4 | i | i | d | i | i | d n | i | =q Wxu | D]m } t | d o | i | i | /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR
s: 55 #
c C s( | i i p | i i | n d S( N( R t lockedR R ( R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR K s c C s d S( sA
blit the canvas in bbox (default entire canvas)
N( ( R Ra ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt blitO s c C s d S( s/
set the canvas size in pixels
N( ( R R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt resizeU s c C s/ d } t | | | } | i i | | d S( sx
This method will be call all functions connected to the
'draw_event' with a :class:`DrawEvent`
R N( R R R ( R R R
t event( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR [ s c C s, d } t | | } | i i | | d S( s|
This method will be call all functions connected to the
'resize_event' with a :class:`ResizeEvent`
R N( R R R ( R R
R* ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR e s c C sJ | | _ d } t | | | | i | i d | } | i i | | d S( s|
This method will be call all functions connected to the
'key_press_event' with a :class:`KeyEvent`
R R N( R R R R R R ( R R R R
R* ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR o s $c C sJ d } t | | | | i | i d | } | i i | | d | _ d S( s~
This method will be call all functions connected to the
'key_release_event' with a :class:`KeyEvent`
R R N( R R R R R R R ( R R R R
R* ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR y s $c K s5 d } t | | | | | } | i i | | d S( s
This method will be called by artists who are picked and will
fire off :class:`PickEvent` callbacks registered listeners
R N( R R R ( R R R R R
R* ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s c C sm | d j o
d | _ n
d | _ d } t | | | | | i | i d | d | } | i i | | d S( sI
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.
This method will be call all functions connected to the
'scroll_event' with a :class:`MouseEvent` instance.
i t upt downR R R N( R R R R R ( R R R R R R
R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s
c C sJ | | _ d } t | | | | | | i d | } | i i | | d S( sX
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 :class:`MouseEvent`.
This method will be call all functions connected to the
'button_press_event' with a :class:`MouseEvent` instance.
R R N( R R R R R ( R R R R R R
R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s
$c C sJ d } t | | | | | | i d | } | i i | | d | _ d S( s
Backend derived classes should call this function on any mouse
button release.
*x*
the canvas coordinates where 0=left
*y*
the canvas coordinates where 0=bottom
*guiEvent*
the native UI event that generated the mpl event
This method will be call all functions connected to the
'button_release_event' with a :class:`MouseEvent` instance.
R R N( R R R R R R ( R R R R R R
R* ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s $c C sW | | | _ | _ d } t | | | | | i | i d | } | i i | | d S( s
Backend derived classes should call this function on any
motion-notify-event.
*x*
the canvas coordinates where 0=left
*y*
the canvas coordinates where 0=bottom
*guiEvent*
the native UI event that generated the mpl event
This method will be call all functions connected to the
'motion_notify_event' with a :class:`MouseEvent` instance.
R R N( R R R R R R R ( R R R R R
R* ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s
c C s# | i i d t i d t _ d S( s
Backend derived classes should call this function when leaving
canvas
*guiEvent*
the native UI event that generated the mpl event
R N( R R R R R ( R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt leave_notify_event s c C s) t d | | } | i i d | d S( s
Backend derived classes should call this function when entering
canvas
*guiEvent*
the native UI event that generated the mpl event
R N( R R R ( R R R* ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt enter_notify_event s c C s2 d } t | | d | } | i i | | d S( s call when GUI is idleR R N( R R R ( R R R
R* ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s c O s d S( s?
Render the :class:`~matplotlib.figure.Figure`
N( ( R t argsR ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt draw s c O s | i | | d S( sX
:meth:`draw` only if idle; defaults to draw but backends can overrride
N( R0 ( R R/ R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s c C s d S( s
Draw a cursor in the event.axes if inaxes is not None. Use
native GUI drawing for efficiency if possible
N( ( R R* ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt draw_cursor
s c C s( t | i i i t | i i i f S( s
return the figure width and height in points or pixels
(depending on the backend), truncated to integers
( t intR Ra R R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s s Enhanced Metafilet emfs Encapsulated Postscriptt epss Portable Document Formatt pdfs Portable Network Graphicst pngt
Postscriptt pss Raw RGBA bitmapt rawt rgbas Scalable Vector Graphicst svgt svgzc O s/ d d k l } | i | } | i | | S( Ni( t FigureCanvasEMF( t backends.backend_emfR= t switch_backendst print_emf( R R/ R R= R3 ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR@ ) s c O s/ d d k l } | i | } | i | | S( Ni( t FigureCanvasPS( t backends.backend_psRA R? t print_eps( R R/ R RA R8 ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRC . s c O s/ d d k l } | i | } | i | | S( Ni( t FigureCanvasPdf( t backends.backend_pdfRD R? t print_pdf( R R/ R RD R5 ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRF 3 s c O s/ d d k l } | i | } | i | | S( Ni( t FigureCanvasAgg( t backends.backend_aggRG R? t print_png( R R/ R RG t agg( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRI 8 s c O s/ d d k l } | i | } | i | | S( Ni( RA ( RB RA R? t print_ps( R R/ R RA R8 ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRK = s c O s/ d d k l } | i | } | i | | S( Ni( RG ( RH RG R? t print_raw( R R/ R RG RJ ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRL B s c O s/ d d k l } | i | } | i | | S( Ni( t FigureCanvasSVG( t backends.backend_svgRM R? t print_svg( R R/ R RM R; ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRO H s c O s/ d d k l } | i | } | i | | S( Ni( RM ( RN RM R? t
print_svgz( R R/ R RM R; ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRP M s c C s | i S( N( t filetypes( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt get_supported_filetypesR s c C sQ h } xD | i i D]3 \ } } | i | g i | | | i q W| S( N( RQ t itemst
setdefaultR# R ( R t groupingst extR ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt get_supported_filetypes_groupedU s R t portraitc K s | d j o t i | o t i i | d d } n | d j p
| d j o; | i } t i | o | i d d | } q q n | i } d | } | | i j p t
| | o< | i i } | i t
d | d i | f n | d j o t d } n | i i }
| i i } | i i } | | i _ | i i | | i i | | i d d }
|
o |
d j o t | | t i d
| d | d | d
| d t | } | i i } | i i | }
| i d d } |
i | }
n t i | i | |
} |
| f } n d } z: t | | | d
| d | d | d
| d | | } Wd |
o | o | n |
| i _ | i i | | i i | | i i | X| S( s7
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.
Arguments are:
*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
i t t .s print_%ss4 Format "%s" is not supported.
Supported formats: %s.s , s savefig.dpit bbox_inchest tightt dpit facecolort edgecolort orientationt dryrunt
pad_inchesg?t bbox_inches_restoreN(! R Rs t is_string_liket osR t splitextt get_default_filetypet rstript lowerRQ R t keysR R t joinR R R] R$ R R# R" t popt getattrt cStringIOt StringIORi t _cachedRenderert
get_tightbboxt paddedt
tight_bboxt adjust_bboxR ( R t filenameR] R^ R_ R` t formatR t method_namet formatst origDPIt
origfacecolort
origedgecolorR[ t resultR t padt restore_bboxt _bbox_inches_restore( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt print_figure\ sv
#
c C s
t d S( N( R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyRg s c C s( t | d o | i i | n d S( s
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).
t managerN( R R t set_window_title( R t title( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s c C s | | i } | S( sO
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
( R ( R t FigureCanvasClasst newCanvas( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR? s c C s | i i | | S( s
Connect event with string *s* to *func*. The signature of *func* is::
def func(event)
where event is a :class:`matplotlib.backend_bases.Event`. The
following events are recognized
- 'button_press_event'
- 'button_release_event'
- 'draw_event'
- 'key_press_event'
- 'key_release_event'
- 'motion_notify_event'
- 'pick_event'
- 'resize_event'
- 'scroll_event'
- 'figure_enter_event',
- 'figure_leave_event',
- 'axes_enter_event',
- 'axes_leave_event'
For the location events (button and key press/release), if the
mouse is over the axes, the variable ``event.inaxes`` will be
set to the :class:`~matplotlib.axes.Axes` the event occurs is
over, and additionally, the variables ``event.xdata`` and
``event.ydata`` will be defined. This is the mouse location
in data coords. See
:class:`~matplotlib.backend_bases.KeyEvent` and
:class:`~matplotlib.backend_bases.MouseEvent` for more info.
Return value is a connection id that can be used with
:meth:`~matplotlib.backend_bases.Event.mpl_disconnect`.
Example usage::
def on_press(event):
print 'you pressed', event.button, event.xdata, event.ydata
cid = canvas.mpl_connect('button_press_event', on_press)
( R t connect( R R
t func( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s ,c C s | i i | S( s
disconnect callback id cid
Example usage::
cid = canvas.mpl_connect('button_press_event', on_press)
#...later
canvas.mpl_disconnect(cid)
( R t
disconnect( R t cid( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt mpl_disconnect s
c C s
t d S( sg
Flush the GUI events for the figure. Implemented only for
backends with GUIs.
N( R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt flush_events$ s c C s
t d S( s|
Start an event loop. This is used to start a blocking event
loop so that interactive functions, such as ginput and
waitforbuttonpress, can wait for events. This should not be
confused with the main GUI event loop, which is always running
and has nothing to do with this.
This is implemented only for backends with GUIs.
N( R ( R t timeout( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt start_event_loop+ s
c C s
t d S( s
Stop an event loop. This is used to stop a blocking event
loop so that interactive functions, such as ginput and
waitforbuttonpress, can wait for events.
This is implemented only for backends with GUIs.
N( R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt stop_event_loop7 s i c C s d } | d 7} t i | t | d j o
t i } n d } d } t | _ xA | i o6 | | | j o% | i t i | | d 7} qR Wd S( s'
Start an event loop. This is used to start a blocking event
loop so that interactive functions, such as ginput and
waitforbuttonpress, can wait for events. This should not be
confused with the main GUI event loop, which is always running
and has nothing to do with this.
This function provides default event loop functionality based
on time.sleep that is meant to be used until event loop
functions for each of the GUI backends can be written. As
such, it throws a deprecated warning.
Call signature::
start_event_loop_default(self,timeout=0)
This call blocks until a callback function triggers
stop_event_loop() or *timeout* is reached. If *timeout* is
<=0, never timeout.
s0 Using default event loop until function specifics to this GUI is implementedi g{Gz?i N(
t warningst warnt DeprecationWarningR< t infRi t _loopingR t timet sleep( R R t strt timestept counter( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt start_event_loop_defaultA s
c C s
t | _ d S( s
Stop an event loop. This is used to stop a blocking event
loop so that interactive functions, such as ginput and
waitforbuttonpress, can wait for events.
Call signature::
stop_event_loop_default(self)
N( R R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt stop_event_loop_defaultc s
N(3 Rw Rx Ry R R R R
R R R( R) R R R R R R R R R R- R. R R0 R R1 R RQ R@ RC RF RI RK RL t print_bmpt print_rgbRO RP RR RW R Rg R R? R R R R R R R ( ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s " +
v .
"t FigureManagerBasec B sM e Z d Z d Z d Z d Z d Z d Z d Z d Z RS( s
Helper class for matlab mode, wraps everything up into a neat bundle
Public attibutes:
*canvas*
A :class:`FigureCanvasBase` instance
*num*
The figure nuamber
c C s5 | | _ | | _ | | _ | i i d | i d S( NR ( R R t numR t key_press( R R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR } s c C s d S( N( ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt destroy s c C s d S( N( ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt full_screen_toggle s c C s d S( s) For gui backends: resize window in pixelsN( ( R R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR) s c C s | i d j o | i n2| i d j p | i d j p | i d j o | i i i n | i d j p | i d j p | i d j o | i i i n | i d j p | i d j o | i i i nv | i d
j o | i i i nR | i d j o | i i i n. | i d j o | i i i | i i n | i
d j o d S| i d
j o | i
i | i i
n| i d j ou | i
} | i } | d j o! | i d | i i i
q| d j o! | i d | i i i
qn | i d j o | i i o | i d j p | i d j o | i d j o t | i d } n x t | i i i D]t \ } } | i d j oX | i d j oH | i | o8 | i d j o | i t q | i | | j qqWn d S( Nt fR t rt homet leftt ct backspacet rightt vR t oR
t gt lt logt lineart 0R i ( R R R t toolbarR t backt forwardt pant zoomt save_figureR R t gridR0 t
get_yscalet
set_yscaleR t isdigitR2 t enumerateR R R R t set_navigateRi ( R R* t axt scalet nRK R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR sJ 00
@ 0c C s d S( s8
Display message in a popup -- GUI only
N( ( R t msg( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt
show_popup s c C s d S( s
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).
N( ( R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s (
Rw Rx Ry R R R R) R R R ( ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR q s 8 t Cursorsc B s e Z e d \ Z Z Z Z RS( i ( Rw Rx t ranget HANDt POINTERt
SELECT_REGIONt MOVE( ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s t NavigationToolbar2c B s e Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
d Z d
Z d Z
d Z d
Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z RS( s
Base class for the navigation cursor, version 2
backends must implement a canvas that handles connections for
'button_press_event' and 'button_release_event'. See
:meth:`FigureCanvasBase.mpl_connect` for more information
They must also define
:meth:`save_figure`
save the current figure
:meth:`set_cursor`
if you want the pointer icon to change
:meth:`_init_toolbar`
create your toolbar widget
:meth:`draw_rubberband` (optional)
draw the zoom to rect "rubberband" rectangle
:meth:`press` (optional)
whenever a mouse button is pressed, you'll be notified with
the event
:meth:`release` (optional)
whenever a mouse button is released, you'll be notified with
the event
:meth:`dynamic_update` (optional)
dynamically update the window while navigating
:meth:`set_message` (optional)
display message
:meth:`set_history_buttons` (optional)
you can change the history back / forward buttons to
indicate disabled / enabled state.
That's it, we'll do the rest!
c C s | | _ | | _ t i | _ t i | _ d | _ d | _ d | _ d | _
d | _ | i | i i
d | i | _ d | _ d | _ | i d S( NR RY ( R R Rs t Stackt _viewst
_positionsR t _xypresst _idPresst
_idReleaseR t _lastCursort
_init_toolbarR t
mouse_movet _idDragt _button_pressedt modet set_history_buttons( R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s
c C s d S( s- display a message on toolbar or in status barN( ( R R
( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt set_message s c G s2 | i i | i i | i | i d S( s move back up the view lim stackN( R R R R t _update_view( R R/ ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s
c C s d S( N( ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt dynamic_update# s c C s d S( s3 draw a rectangle rubberband to indicate zoom limitsN( ( R R* t x0t y0t x1t y1( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt draw_rubberband& s c G s2 | i i | i i | i | i d S( s" move forward in the view lim stackN( R R R R R ( R R/ ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR * s
c G s2 | i i | i i | i | i d S( s restore the original viewN( R R R R R ( R R/ ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR 1 s
c C s
t d S( s
This is where you actually build the GUI widgets (called by
__init__). The icons ``home.xpm``, ``back.xpm``, ``forward.xpm``,
``hand.xpm``, ``zoom_to_rect.xpm`` and ``filesave.xpm`` are standard
across backends (there are ppm versions in CVS also).
You just need to set the callbacks
home : self.home
back : self.back
forward : self.forward
hand : self.pan
zoom_to_rect : self.zoom
filesave : self.save_figure
You only need to define the last one - the others are in the base
class implementation.
N( R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR 8 s c C s | i p | i o7 | i t i j o | i t i t i | _ q0n | i d j o | i t i j o | i t i t i | _ n | i oO | i | i } } | i d \ } } } } } } | i
| | | | | q0nD | i d j o3 | i t i j o | i t i t i | _ n | i o | i i o y | i i
| i | i }
Wn% t j
o qt j
o qXt | i o | i d | i |
f q| i |
n | i | i d S( Nt ZOOMi t PANs %s, %s( R R R t cursorsR t
set_cursorR R R R R R t get_navigatet format_coordR R R t
OverflowErrorR R R ( R R* R R t lastxt lastyR t indt limR R
( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR N s6
! c G sA | i d j o
d | _ n
d | _ | i d j o% | i i | i | _ d | _ n | i d j o% | i i | i | _ d | _ n | i oS | i i d | i | _ | i i d | i | _ d | _ | i i
| n | i i
i | x* | i i i
D] } | i | i qW| i | i d S( sA Activate the pan/zoom tool. pan with left button, zoom with rightR RY R R s pan/zoomN( R R R R R R R R t press_pant release_panR t releaseR R t set_navigate_modeR ( R R/ R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR p s*
c C s d S( s5 this will be called whenver a mouse button is pressedN( ( R R* ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt press s c C sP | i d j o
d | _ n+ | i d j o
d | _ n d | _ d S| i | i } } | i i o | i n g | _ x t | i
i i D] \ } } | d j o | d j o{ | i
| ok | i o^ | i | | | i | i i | | f | i
i | i | i
i d | i | _ q q W| i | d S( s0 the press mouse button in pan/zoom mode callbacki i NR ( R R R R R R t emptyt push_currentR R R R R R R t start_panR# R R R t drag_panR ( R R* R R RK R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s$
7#c C s7 | i d j o
d | _ n+ | i d j o
d | _ n d | _ d S| i | i } } | i i o | i n g | _ x t | i
i i D] \ } } | d j oo | d j ob | i
| oR | i oE | i o8 | i i | | | | | i i | i i f q q W| i | d S( s4 the press mouse button in zoom to rect mode callbacki i N( R R R R R R R R R R R R R R R t can_zoomR# t viewLimt frozenR R ( R R* R R RK R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt
press_zoom s
*<c C s g } g } x | i i i D]q } | i \ } } | i \ } } | i | | | | f | i | i t i | i i f q W| i i
| | i i
| | i d S( s8 push the current view limits and position onto the stackN(
R R R t get_xlimt get_ylimR# t get_positionRi R R t pushR R ( R t limst posR t xmint xmaxt ymint ymax( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s c C s d S( s5 this will be called whenever mouse button is releasedN( ( R R* ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s c C s | i d j o d S| i i | i | i i d | i | _ x! | i D] \ } } | i qM W| i p d Sg | _ d | _ | i | i
| | i d S( s2 the release mouse button callback in pan/zoom modeNR ( R R R R R R R R t end_panR R R0 ( R R* R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s
c C sJ x9 | i D]. \ } } | i | i | i | i | i q
W| i d S( s" the drag callback in pan/zoom modeN( R R R R R R R ( R R* R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s
&c C s@ | i p d Sg } x| i D]} | i | i } } | \ } } } } }
} t | | d j p t | | d j o% d | _ | i | | i d S|
i \ } }
} } | i i } | i
| | f \ } } | i
| | f \ } } | i \ } } | i \ } } t
t
} } | o[ xX | D]L } | i i | | o
t } n | i i | | o
t } q<q<Wn | i | | o | | } } n | | j o] | | j o | | } } n | | } } | | j o
| } n | | j o
| } qxnZ | | j o | | } } n | | } } | | j o
| } n | | j o
| } n | o | | }
} n | | j o] | | j o | | }
} n | | }
} |
| j o
| }
n | | j o
| } qSnZ | | j o | | }
} n | | }
} |
| j o
| }
n | | j o
| } n | i d j o* | i | | f | i |
| f q | i d j oh| i d j oV t i | | t i | | } t | | | | } t | | | | } n7 | | | | } | | | | } | | | | } | i d j oV t i | | t i | |
} t | |
| | } t | |
| | } n7 | | | |
} | | |
| } | | |
| } | i | | f | i | | f q q W| i d | _ d | _ | i | i | d S( s6 the release mouse button callback in zoom to rect modeNi i i R ( R R R t absR R R0 t extentsR R R R R R t get_shared_x_axest joinedRi t get_shared_y_axesR# R t set_xlimt set_ylimt
get_xscaleR< R t powR R ( R R* t last_at cur_xypressR R R R R R R R R R R R t inverset Xmint Xmaxt Ymint Ymaxt twinxt twinyt laR t rx1t rx2t ry1t ry2( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt release_zoom s
.
$$
c C s x | i i i D] } t | d d } t | d d } g } | d j o* | i | i | i | i n | d j o* | i | i | i | i n x | D] } | i q Wq W| i i d S( s( redraw the canvases, update the locatorst xaxist yaxisN(
R R R Rm R R# t get_major_locatort get_minor_locatort refreshR0 ( R R R R t locatorst loc( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR0 M s
c C s | i } | d j o d S| i } | d j o d Sx t | i i i D]x \ } } | | \ } } } } | i | | f | i | | f | i | | d d | i | | d d qU W| i
d S( s_ update the viewlim and position from the view and
position stack for each axes
Ni t originali t active( R R R R R R R R R t set_positionR0 ( R R R RK R R R R R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR ` s
c G s
t d S( s save the current figureN( R ( R R/ ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR t s c C s d S( s\
Set the current cursor to one of the :class:`Cursors`
enums values
N( ( R t cursor( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR x s c C s( | i i | i i | i d S( s reset the axes stackN( R t clearR R ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s
c G sA | i d j o
d | _ n
d | _ | i d j o% | i i | i | _ d | _ n | i d j o% | i i | i | _ d | _ n | i oS | i i d | i | _ | i i d | i | _ d | _ | i i
| n | i i
i | x* | i i i
D] } | i | i qW| i | i d S( s activate zoom to rect modeR RY R R s zoom rectN( R R R R R R R R R R R R R R R R ( R R/ R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s&
c C s d S( s% enable or disable back/forward buttonN( ( R ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s ( Rw Rx Ry R R R R R R R R R R R R R R R R R R R0 R R R R R R ( ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyR s4 * " \ () Ry t
__future__R Re R R t numpyR< t matplotlib.cbookRs t matplotlib.colorsR t matplotlib.transformsR t matplotlib.widgetsR t matplotlib.pathR t
matplotlibR R R R Rn t matplotlib.tight_bboxRs R Rp R R R R R R R R R R R R R ( ( ( s> /usr/lib64/python2.6/site-packages/matplotlib/backend_bases.pyt s> $ { a-( c