'Grab the image information from the figure and save as a movie frame.
All keyword arguments in savefig_kwargs are passed on to the \'savefig\'
command that saves the figure.'

def grab_frame(self, **savefig_kwargs):

    verbose.report(u'MovieWriter.grab_frame:    Grabbing    frame.', level=u'debug')
    try:
        self.fig.set_size_inches(self._w, self._h)
        self.fig.savefig(self._frame_sink(), format=self.frame_format, dpi=self.dpi, **savefig_kwargs)
    except (RuntimeError, IOError) as e:
        (out, err) = self._proc.communicate()
        verbose.report((u'MovieWriter    --    Error    running    proc:\n%s\n%s' % (out, err)), level=u'helpful')
        raise IOError(u'Error    saving    animation    to    file    (cause:    {0})    Stdout:    {1}    StdError:    {2}.    It    may    help    to    re-run    with    --verbose-debug.'.format(e, out, err))
