Scilab Home Page | Wiki | Bug Tracker | Forge | Mailing List Archives | Scilab Online Help | File Exchange
ATOMS : gui2bitmap details
Login with GitLab


get a bitmap image of a graphical figure or interface, including its uicontrols, nay window borders
(6706 downloads for this version - 28637 downloads for all versions)
A more recent valid version with binaries for Scilab 6.0 exists: 1.2
Samuel Gougeon
Samuel Gougeon
Creation Date
August 5, 2019
Source created on
Scilab 6.0.x
Binaries available on
Scilab 5.5.x:
Windows 64-bit Windows 32-bit Linux 64-bit Linux 32-bit macOS
Scilab 6.0.x:
Windows 64-bit Windows 32-bit Linux 64-bit Linux 32-bit macOS
Install command
--> atomsInstall("gui2bitmap")
gui2bitmap(…) takes a snapshot of the given graphical figure and stores it in
an image file. .png .jpg .gif and .bmp output encodings are supported.

It is a stand-alone Scilab function using only the JVM embedded in Scilab.
It does not require any external software,  nor any hardcode compilation.
It aims to remedy to xs2png(…), xs2jpg(…), xs2gif(…), and xs2bmp(…).
Unlike them, it is able to
* include uicontrols (if any) in the image, as they appear on the GUI figure;
* snapshot the whole window embedding the figure, including the window 
  menus tools and status bars, and borders.

gui2bitmap(idFig, filename)
gui2bitmap(idFig, filename, withBorders)

idFig      : handle of the figure
filename   : pathname to the output image file
withBorders: boolean

PDF page:

Bugs reports, comments:
Every user report is welcome, for success and failure, in particular on the
following OSes: Win10, Linux, MacOS X with/without retina display:
Files (5)
[119.58 kB]
Source code archive

[239.34 kB]
OS-independent binary for Scilab 5.5.x

[243.18 kB]
OS-independent binary for Scilab 6.0.x

CHANGES 1.0 => 1.1
* On Windows, any graphical window that is partly shifted off-screen
  is now managed.
* On slow computers, sometimes the snapshot shew some overlaying window
  instead of the Graphical one.
* Loading the library was bugged with Scilab 5.5.2.
* In case of NWNI mode, the error message was wrong.

[249.41 kB]
Miscellaneous file
gui2bitmap() online help page (english)
[250.82 kB]
Miscellaneous file
gui2bitmap() page d'aide en ligne (french)
News (0)
Comments (0)
Leave a comment
You must register and log in before leaving a comment.
Login with GitLab
Email notifications
Send me email when this toolbox has changes, new files or a new release.
You must register and log in before setting up notifications.