java.lang.String captureEntirePageScreenshotToString(java.lang.String kwargs)
java.lang.String captureScreenshotToString()

import base64 
 
...
 
    def _absnorm(self, path):
        return os.path.normpath(os.path.abspath(path.replace('/', os.sep)))
 
    def _write_to_file(self, path, content, mode):
        path = self._absnorm(path)
        parent = os.path.dirname(path)
        if not os.path.exists(parent):
            os.makedirs(parent)
        f = open(path, mode+'b')
        f.write(content)
        f.close()
        return path
 
    def capture_remote_screenshot(self, path=None):
        """Captures a screenshot and returns it as a string
 
        Given path must be relative to Robot Framework output directory,
        otherwise the embedded image is not shown in the log file. If path is
        not given, file with name similar to 'selenium-image-x.png' is created
        directly under the output directory.
        """
 
        # configure path
        if path and os.path.isabs(path):
            raise RuntimeError("Given path must be relative to Robot outpudir")
        if not path:
            path = self._namegen.next()
        outdir = NAMESPACES.current.variables['${outputdir}']
        fullpath = os.path.join(outdir, path)
        if not os.path.exists(os.path.split(fullpath)[0]):
            os.makedirs(os.path.split(fullpath)[0])
 
        # retrieve remote screenshot
        self._info("Retrieving Screenshot")
        screenshot = self._selenium.capture_entire_page_screenshot_to_string("background=#CCFFDD")
        screenshot=base64.b64decode(screenshot)
 
        # save screenshot
        self._info("Saving screenshot to file '%s'" % fullpath)
        self._write_to_file(fullpath, screenshot, 'w')
        self._html('
<td></td>
</tr>
<tr>
<td colspan="3"><a href="http://blog.codecentric.de/2010/02/remote-screenshots-mit-selenium-und-dem-robot-framework/">'                   '</a></td>
</tr>
' % (path, path))

Selenium.prototype.doCaptureEntirePageScreenshot = function(filename, kwargs) {
    /**
     * Saves the entire contents of the current window canvas to a PNG file.
     * Contrast this with the captureScreenshot command, which captures the
     * contents of the OS viewport (i.e. whatever is currently being displayed
     * on the monitor), and is implemented in the RC only. Currently this only
     * works in Firefox when running in chrome mode, and in IE non-HTA using
     * the EXPERIMENTAL "Snapsie" utility. The Firefox implementation is mostly
     * borrowed from the Screengrab! Firefox extension. Please see
     * http://www.screengrab.org and http://snapsie.sourceforge.net/ for
     * details.
     *
     * @param filename  the path to the file to persist the screenshot as. No
     *                  filename extension will be appended by default.
     *                  Directories will not be created if they do not exist,  
     *                  and an exception will be thrown, possibly by native
     *                  code.
     * @param kwargs    a kwargs string that modifies the way the screenshot
     *                  is captured. Example: "background=#CCFFDD" .
     *                  Currently valid options:
     *                  <dl>
     *                   <dt>background</dt>
     *                     <dd>the background CSS for the HTML document. This
     *                     may be useful to set for capturing screenshots of
     *                     less-than-ideal layouts, for example where absolute
     *                     positioning causes the calculation of the canvas
     *                     dimension to fail and a black background is exposed
     *                     (possibly obscuring black text).</dd>
     *                  </dl>
     */
    if (! browserVersion.isChrome &&
        ! (browserVersion.isIE && ! browserVersion.isHTA)) {
        throw new SeleniumError('captureEntirePageScreenshot is only '
            + 'implemented for Firefox ("firefox" or "chrome", NOT '
            + '"firefoxproxy") and IE non-HTA ("iexploreproxy", NOT "iexplore" '
            + 'or "iehta"). The current browser isn\'t one of them!');
    }
    // do or do not ... there is no try
 
    if (browserVersion.isIE) {
        // targeting snapsIE >= 0.2
        function getFailureMessage(exceptionMessage) {
            var msg = 'Snapsie failed: ';
            if (exceptionMessage) {
                if (exceptionMessage ==
                    "Automation server can't create object") {
                    msg += 'Is it installed? Does it have permission to run '
                        + 'as an add-on? See http://snapsie.sourceforge.net/';
                }
                else {
                    msg += exceptionMessage;
                }
            }
            else {
                msg += 'Undocumented error';
            }
            return msg;
        }
 
        if (typeof(runOptions) != 'undefined' &&
            runOptions.isMultiWindowMode() == false) {
            // framed mode
            try {
                Snapsie.saveSnapshot(filename, 'selenium_myiframe');
            }
            catch (e) {
                throw new SeleniumError(getFailureMessage(e.message));
            }
        }
        else {
            // multi-window mode
            if (!this.snapsieSrc) {
                // XXX - cache snapsie, and capture the screenshot as a
                // callback. Definitely a hack, because we may be late taking
                // the first screenshot, but saves us from polluting other code
                // for now. I wish there were an easier way to get at the
                // contents of a referenced script!
                if (/.hta/.exec(snapsieUrl))
                {
                    snapsieUrl = "http://localhost:4444/selenium-server/Core/lib/snapsie.js";
                }
                var self = this;
                new Ajax.Request(snapsieUrl, {
                    method: 'get'
                    , onSuccess: function(transport) {
                        self.snapsieSrc = transport.responseText;
                        self.doCaptureEntirePageScreenshot(filename, kwargs);
                    }
                });
                return;
            }
 
            // it's going into a string, so escape the backslashes
            filename = filename.replace(/\\/g, '\\\\');
 
            // this is sort of hackish. We insert a script into the document,
            // and remove it before anyone notices.
            var doc = selenium.browserbot.getDocument();
            var script = doc.createElement('script'); 
            var scriptContent = this.snapsieSrc
				+ 'try {'
                + '    Snapsie.saveSnapshot("' + filename + '");'
                + '}'
                + 'catch (e) {'
                + '    document.getElementById("takeScreenshot").failure ='
                + '        e.message;'
                + '}';
            script.id = 'takeScreenshot';
            script.language = 'javascript';
            script.text = scriptContent;
            doc.body.appendChild(script);
            script.parentNode.removeChild(script);
            if (script.failure) {
                throw new SeleniumError(getFailureMessage(script.failure));
            }
        }
        return;
    }