doc: Fill in high level description for Surfaces

Signed-off-by: Bryce Harrington <bryce@osg.samsung.com>
Reviewed-by: Jon A. Cruz <jonc@osg.samsung.com>
This commit is contained in:
Bryce Harrington 2015-01-27 16:32:16 -08:00
parent 8094426a41
commit 310fea467c

View file

@ -282,9 +282,16 @@
<section id="sect-Protocol-Surface"> <section id="sect-Protocol-Surface">
<title>Surfaces</title> <title>Surfaces</title>
<para> <para>
Surfaces are created by the client. A surface manages a rectangular grid of pixels that clients create
Clients don't know the global position of their surfaces, and for displaying their content to the screen. Clients don't know
cannot access other clients surfaces. the global position of their surfaces, and cannot access other
clients' surfaces.
</para>
<para>
Once the client has finished writing pixels, it 'commits' the
buffer; this permits the compositor to access the buffer and read
the pixels. When the compositor is finished, it releases the
buffer back to the client.
</para> </para>
<para> <para>
See <xref linkend="protocol-spec-wl_surface"/> for the protocol See <xref linkend="protocol-spec-wl_surface"/> for the protocol