diff options
author | Michal Krol <michal@vmware.com> | 2010-03-16 10:58:33 +0100 |
---|---|---|
committer | Michal Krol <michal@vmware.com> | 2010-03-16 10:58:33 +0100 |
commit | e4b8a307b25146202b1fb64339b307bde5ec3b30 (patch) | |
tree | 4655dab3bccec4628d27a15b6bf175052ec90c35 | |
parent | 8cdfd1219a2d13d252a8691ee6dddb0d773bdc77 (diff) | |
download | external_mesa3d-e4b8a307b25146202b1fb64339b307bde5ec3b30.zip external_mesa3d-e4b8a307b25146202b1fb64339b307bde5ec3b30.tar.gz external_mesa3d-e4b8a307b25146202b1fb64339b307bde5ec3b30.tar.bz2 |
gallium/docs: Create a separate section for Sampler Views.
-rw-r--r-- | src/gallium/docs/source/context.rst | 52 |
1 files changed, 35 insertions, 17 deletions
diff --git a/src/gallium/docs/source/context.rst b/src/gallium/docs/source/context.rst index ef3e463..1f02257 100644 --- a/src/gallium/docs/source/context.rst +++ b/src/gallium/docs/source/context.rst @@ -41,23 +41,6 @@ buffers, surfaces) are bound to the driver. * ``set_framebuffer_state`` -* ``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`` @@ -79,6 +62,41 @@ objects. They all follow simple, one-method binding calls, e.g. * ``set_viewport_state`` +Sampler Views +^^^^^^^^^^^^^ + +These are the means to bind textures to shader stages. To create one, specify +its format, swizzle and LOD range in sampler view template. + +If texture format is different than template format, it is said the texture +is being cast to another format. Casting can be done only between compatible +formats, that is formats that have matching component order and sizes. + +Swizzle fields specify they way in which fetched texel components are placed +in the result register. For example, swizzle_r specifies what is going to be +placed in destination register x (AKA r). + +first_level and last_level fields of sampler view template specify the LOD +range the texture is going to be constrained to. + +* ``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. + + Clearing ^^^^^^^^ |