xserver-multidpi/doc
Keith Packard 9d457f9c55 Add screen-specific privates.
Screen-specific privates areas are only allocated for objects related
to the target screen; objects allocated for other screens will not
have the private space reserved. This saves memory in these objects
while also allowing hot-plug screens to have additional private
allocation space beyond what the core screens are using.

Drivers are encouraged to switch to this mechanism as it will reduce
memory usage in multi-GPU environments, but it is only required for
drivers which will be loaded after the server starts, like
modesetting.

Objects providing screen-specific privates *must* be managed by the
screen-specific private API when allocating or initializing privates
so that the per-screen area can be initialized properly.

The objects which support screen-specific privates are:

	Windows
	Pixmaps
	GCs
	Pictures

Extending this list to include Colormaps would be possible, but
require slightly more work as the default colormap is created before
all colormap privates are allocated during server startup, and hence
gets a bunch of special treatment.

Of particular note, glyphs are *not* capable of supporting
screen-specific privates as they are global objects, not allocated on
a screen-specific basis, and so each driver must be able to see their
privates within the glyph.

Signed-off-by: Keith Packard <keithp@keithp.com>
Reviewed-by: Dave Airlie <airlied@redhat.com>
2012-07-05 13:39:50 -07:00
..
dtrace dix: add dtrace probes to input API 2012-03-22 11:33:42 +10:00
.gitignore doc: use devbook.am for developers documentation 2011-05-14 11:22:29 -07:00
c-extensions Document more of the OS and library assumptions. 2008-07-31 15:50:23 -04:00
Makefile.am doc: use devbook.am for developers documentation 2011-05-14 11:22:29 -07:00
smartsched Merging XORG-CURRENT into trunk 2004-04-23 19:54:30 +00:00
Xinput.xml docs: spell "X Server Version" consistently in titles. Add where missing. 2011-11-21 10:34:23 -08:00
Xserver-spec.xml Add screen-specific privates. 2012-07-05 13:39:50 -07:00