Mesa (master): docs: PIPE_TEXTURE_USAGE info.

[Corbin Simpson]

Module: Mesa
Branch: master
Commit: 9811ebf61f5d1220ef0c7e33e6677304e9b31052
URL:    http://cgit.freedesktop.org/mesa/mesa/commit/?id=9811ebf61f5d1220ef0c7e33e6677304e9b31052

Author: Corbin Simpson <MostAwesomeDude at gmail.com>
Date:   Mon Jan 18 15:09:30 2010 -0800

docs: PIPE_TEXTURE_USAGE info.

>From IRC with Jakob.

---

 src/gallium/docs/source/screen.rst |   24 ++++++++++++++++++++++++
 1 files changed, 24 insertions(+), 0 deletions(-)

diff --git a/src/gallium/docs/source/screen.rst b/src/gallium/docs/source/screen.rst
index 9631e69..8cb7c70 100644
--- a/src/gallium/docs/source/screen.rst
+++ b/src/gallium/docs/source/screen.rst
@@ -3,6 +3,26 @@ Screen
 
 A screen is an object representing the context-independent part of a device.
 
+Useful Flags
+------------
+
+PIPE_TEXTURE_USAGE
+^^^^^^^^^^^^^^^^^^
+
+These flags determine the possible roles a texture may be used for during its
+lifetime. Texture usage flags are cumulative and may be combined to create a
+texture that can be used as multiple things.
+
+* ``RENDER_TARGET``: A colorbuffer or pixelbuffer.
+* ``DISPLAY_TARGET``: A sharable buffer that can be given to another process.
+* ``PRIMARY``: A frontbuffer or scanout buffer.
+* ``DEPTH_STENCIL``: A depthbuffer, stencilbuffer, or Z buffer. Gallium does
+  not explicitly provide for stencil-only buffers, so any stencilbuffer
+  validated here is implicitly also a depthbuffer.
+* ``SAMPLER``: A texture that may be sampled from in a fragment or vertex
+  shader.
+* ``DYNAMIC``: XXX undefined
+
 Methods
 -------
 
@@ -33,6 +53,10 @@ is_format_supported
 
 See if a format can be used in a specific manner.
 
+**usage** is a bitmask of ``PIPE_TEXTURE_USAGE`` flags.
+
+Returns TRUE if all usages can be satisfied.
+
 texture_create
 ^^^^^^^^^^^^^^