Mesa (master): gallium/docs: clarify that samplers are not used with PIPE_BUFFER resources

[Brian Paul]

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

Author: Brian Paul <brianp at vmware.com>
Date:   Fri Jun 30 09:23:17 2017 -0600

gallium/docs: clarify that samplers are not used with PIPE_BUFFER resources

Commit 8aba778fa2cd98a0b5a7429d3c5057778a0c808c "st/mesa: don't set
sampler states for TBOs" changed how texture buffer objects are handled.
Document the new convention.

Reviewed-by: Roland Scheidegger <sroland at vmware.com>

---

 src/gallium/docs/source/context.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/gallium/docs/source/context.rst b/src/gallium/docs/source/context.rst
index 6563a7e150..a46131c31f 100644
--- a/src/gallium/docs/source/context.rst
+++ b/src/gallium/docs/source/context.rst
@@ -99,6 +99,14 @@ objects. They all follow simple, one-method binding calls, e.g.
   various debug messages, eventually reported via KHR_debug and
   similar mechanisms.
 
+Samplers
+^^^^^^^^
+
+pipe_sampler_state objects control how textures are sampled (coordinate
+wrap modes, interpolation modes, etc).  Note that samplers are not used
+for texture buffer objects.  That is, pipe_context::bind_sampler_views()
+will not bind a sampler if the corresponding sampler view refers to a
+PIPE_BUFFER resource.
 
 Sampler Views
 ^^^^^^^^^^^^^