Module: Mesa Branch: master Commit: 9811ebf61f5d1220ef0c7e33e6677304e9b31052 URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=9811ebf61f5d1220ef0c7e33e6677304e9b31052
Author: Corbin Simpson <[email protected]> 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 ^^^^^^^^^^^^^^ _______________________________________________ mesa-commit mailing list [email protected] http://lists.freedesktop.org/mailman/listinfo/mesa-commit
