1
0
mirror of https://github.com/moparisthebest/Simba synced 2024-12-25 08:48:51 -05:00
Simba/Doc/sphinx/mmlref/iomanager.rst
2010-06-15 19:15:52 +02:00

54 lines
2.1 KiB
ReStructuredText

IOManager Class
===============
.. note::
This page is still WIP.
It only covers the function of the IOManager class vaguely. In reality, the
IOManager unit contains quite some classes, each with a (slightly) different
function. There are not yet documented. (Perhaps BenLand100 can do this?)
The IOManager class manages the core functionality for retreiving Window data,
such as the actual pixel data and the position and dimension of a window.
The main purpose is to form a cross platform class to retrieve window
information, press and poll mouse buttons and to press and poll keyboard keys.
The IOManager is the only class that should use platform (or operating system)
specific calls; this is all abstracted by the IOManager class.
To achieve this, several abstract classes are defined by the IOManager class.
Every operating system (or window system) needs it's own implementation of the
``TWindow_Abstract`` class. We wrote one for both Linux and Windows.
.. toctree::
:maxdepth: 2
os_linux.rst
os_windows.rst
Offscreen image capturing
-------------------------
On Linux, offscreen image capturing is possible when compositing is turned on.
With compiz, this is turned on by default. Other windows managers like Metacity
and KWin can turn this on. When enabled, Simba can capture images from windows
that are below others. Minimized does not work. It is also possible to turn on
Compositing for specific X11 Windows with an api call, but this is currently not
implemented.
The status on Windows is unknown.
Silent Input
------------
So what is Silent Input?
We define Silent Input as methods to manipulate the user's mouse and keyboard,
without visually using them. So what does this mean?
This basically means that you will still be able to use your mouse while
the MML is performing mouse operations on your targetted window/client.
However, silent input is very hard to implement, and often hardly supported
by host operating systems. Often silent mouse or keyboard input is simply
ignored. So in general it is advised to stick to non silent input.