KDesktop Design Document

Author :
  David Faure, faure@kde.org
  Martin R. Jones, mjones@kde.org (screensaver)
  Geert Jansen, g.t.jansen@stud.tue.nl (background code)

Last modified: 24 Oct 1999

Overall design of KDesktop :
=============================

KDesktop is the program that handles the desktop icons,
the popup menus for the desktop, the mac menubar, and the
screensaver system.

Files :
=======

main.* : main
desktop.* : the icon container for the desktop icons
krootwm.* : right and middle mouse button popup menus, Mac menubar
bg*.*: Background renderer/manager.

icons.* : old code, not used anymore.
  We need to borrow ideas from it for positioning icons after a DnD
 (in kiconcontainer so that it works with konqueror as well)
 - well, only if we want dropped icons to remain where they have been
 dropped :)
  We also need to store the desktop icons position, like was done in kfm.
   and we need to do it for konqy as well.

KDesktopIface* : DCOP interface for kdesktop, used by kfmclient

lock* : screen saver/locker

Libs used by KDesktop
======================
 
kdecore, kdeui, kfile  - usual stuff :)
libkio - I/O stuff, mimetypes, services, registry
libkonq - properties dialog, templates ("new") menu, dir lister, settings

Screensaver
===========

The screensaver now works in a similar way to xscreensaver, i.e. a driver
(kdesktop) provides the timeout, locking, and blanking functionality, but
does no actual drawing.  A separate stand-alone program capable of
drawing on a supplied window is used to do the actual fancy graphics.
xscreensaver's "hacks" will work with the KDE screensaver engine.

This makes adding new screensavers trivial, and means one less process that
must always be running (compared to KDE 1.x).

The screensaver is controlled via DCOP:

KScreensaverIface::configure()  Reloads the screensaver config from desktoprc.
KScreensaverIface::lock()       Locks the screen immediately.
KScreensaverIface::save()       Saves the screen immediately.
KScreensaverIface::isEnabled()  returns true if the screensaver is enabled.
KScreensaverIface::isBlanked()  returns true if the screen is currently blank.

Backgrounds
===========

The new background code is in bgrender.cpp and bgmanager.cpp. Some features:

* Support for xearth like programs.
* Can export a pixmap of the desktop background for pseudo transparency.

Multiple monitors
=================
Two monitors showing different things (not a mirror-setup) can be configured
in X to either use one X screen, or 2 X screens.  Difference is that if I
drag a window from one monitor to the other the application gets asked to
tqrepaint itself on a 2 screen setup and a simple move of the window will be
done in memory (by XFree) if you have a 1 screen setup.

Monitors example:
    +----+ +-----+  2 monitors, with same resolution to keep it simple.
    |    | |     |
    +----+ +-----+

In case of 1 screen (xinerama)
    +------------+
    |            +   desktopGeometry == screenGeometry == 3200 x 1200
    +------------+

In case of 2 screen (multihead)
    +----+ +-----+
    |    | |     |  desktopGeometry = 3200 x 1200
    +----+ +-----+  screenGeometry = 1600 x 1200 (for each monitor)