
gshot r1
(c) notaz, 2008


About
-----

This is a tool which can take screenshots of programs running on GP2X.
Unlike some other similar tools available, gshot uses direct hardware access
instead of Linux API, what allows it to work with more apps. It can handle
all GP2X graphic modes, and programs using hardware scaler.
The screenshots are taken in png format.


Usage
-----

The easiest way to use gshot is to simply run it from menu/launcher. There
you will be presented with a minimal menu where you can select button
combination to use for taking screenshots (can be just a single button too),
and select "Go to background" to start your menu/launcher again. After that
you can press the button combination you previously selected to take
screenshots.
Note that the buttons you press are still registered by the program you run,
so take care to select some combination which does not conflict with something
used by the program you are going to screenshot.
To stop taking screenshots run gshot from your menu again, and choose "exit"
in gshot's menu. Alternatively you can power-cycle your GP2X :)

gshot can also be run from the command line with a filename parameter:
[gp2x] ./gshot.gpu shot.png
this way it will screenshot and exit. Handy for running it from telnet.

There is also fbgrab_mode.gpu provided for those who would like to use gshot
the same way as fbgrab.


Notes
-----

There is no way to take exact screenshots of programs which use the hardware
scaler (you can't get the same image you see on LCD), because the image is
altered by display controller internally. Because of that unscaled image
is taken instead (the actual framebuffer contents).

gshot doesn't currently work with programs using YUV layer (i.e. gpu940).

