slackbuilds/misc/ardesia/README

Ardesia turns your screen into a digital sketchpad to annotate or draw
on the entire screen. It also lets you record and stream it on the
network with vlc. You can draw upon the desktop or import an image
as well as annotate and redistribute it. Ardesia is also pressure
sensitive assuming your device is properly configured.

USER TIPS:

Ardesia functions differently under different window managers.

Fluxbox/Blackbox: D-
Even with cairo-compmgr or xcompmgr these only function with a solid
color background. You may have difficulty selecting tool box, try
launching with '-d'. As for other minimalist window managers, you are
on your own.

XFCE: C
The drawing window has a title bar and you can't type in windows
unless shaded or minimized. Unknown work around for this.

KDE: A+
Default KDE settings will darken the screen. To fix this System
Settings > All Effects Tab > Shadow Properties > Uncheck Active
windows have stronger shadows > Disable Shadows (important if running)
> Click Apply. Optionally re-enable Shadows and click Apply.

GNOME 3.0: F
Sorry, I have no work around for the issues with this window manager.
- The Application hides the bar at the top (you can still access
  Activities with a shortcut key.
- The Tool Box will always be below the drawing window.
- Because of the tool box, the main features of pictures, pdf, and
  screen record can not be accessed.

Other:
If you have 'focus' extensions that gray out everything but the focused
window, you will probably have to disable it. However, if you are using
compiz, you probably are not using ardesia because there is a plugin
for all this functionality.

General:
Depending on the window manager, you may need to launch as "ardesia
-d" to obtain control of the tools panel. This may also require
tweaking of other settings to have the pannel appear on top of the
drawing overlay window. You may have to toggle "always on top" for the
drawing window if you are capable of toggling it seperatly from the
tool box window.

The "mouse option" only seems to effectively work in KDE and
XFCE. This is a pass through mode that will interact with the desktop
below the drawing window.

The PDF export will allow you to add new pages to a pdf that are screen
captures of when the button is pressed. It does not save vector shapes.

Here some xprops of the windows if you can control windows based on
these:

Tool Box:
WM_CLASS(STRING) = "ardesia", "Ardesia"
WM_NAME(STRING) = "Ardesia"

Drawing Window:
WM_CLASS(STRING) = "ardesia", "Ardesia"
WM_NAME(STRING) = "window"


Runtime Required:
- A Composite manager (compiz, kwin, xcompmgr, cairo-compmgr, etc.)

Runtime Optional:
- VLC for recording and streaming