docs: Document sampler view entry points.
authorMichal Krol <michal@vmware.com>
Thu, 25 Feb 2010 14:33:15 +0000 (15:33 +0100)
committerMichal Krol <michal@vmware.com>
Thu, 25 Feb 2010 14:33:15 +0000 (15:33 +0100)
src/gallium/docs/source/context.rst

index 827db8398ce1f0f2df9ef2ddc513279db5df30ba..2d495f5d0e7c82efbbe6fc233ec6af2ef51b156f 100644 (file)
@@ -39,10 +39,24 @@ buffers, surfaces) are bound to the driver.
   are mostly restricted to the first one right now).
 
 * ``set_framebuffer_state``
-* ``set_fragment_sampler_views``
-* ``set_vertex_sampler_views``
-* ``create_sampler_view``
-* ``sampler_view_destroy``
+
+* ``set_fragment_sampler_views`` binds an array of sampler views to
+  fragment shader stage. Every binding point acquires a reference
+  to a respective sampler view and releases a reference to the previous
+  sampler view.
+
+* ``set_vertex_sampler_views`` binds an array of sampler views to vertex
+  shader stage. Every binding point acquires a reference to a respective
+  sampler view and releases a reference to the previous sampler view.
+
+* ``create_sampler_view`` creates a new sampler view. texture is associated
+  with the sampler view which results in sampler view holding a reference
+  to the texture. Format specified in template must be compatible
+  with texture format.
+
+* ``sampler_view_destroy`` destroys a sampler view and releases its reference
+  to associated texture.
+
 * ``set_vertex_buffers``