OpenHarmony/third_party_mesa3d
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

gallium/docs: more info about setting samplers and sampler views

Browse Source 
Plus other assorted clarifications.
This commit is contained in:
Brian Paul
2011-02-03 12:30:19 -07:00
parent c5fb2c60bf
commit 73e37d933d
1 changed files with 23 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
src/gallium/docs/source/context.rst
View File

@@ -3,8 +3,12 @@
Context Context
======= =======
The context object represents the purest, most directly accessible, abilities A Gallium rendering context encapsulates the state which effects 3D
of the device's 3D rendering pipeline. rendering such as blend state, depth/stencil state, texture samplers,
etc.
Note that resource/texture allocation is not per-context but per-screen.
Methods Methods
------- -------
@@ -12,20 +16,23 @@ Methods
CSO State CSO State
^^^^^^^^^ ^^^^^^^^^
All CSO state is created, bound, and destroyed, with triplets of methods that All Constant State Object (CSO) state is created, bound, and destroyed,
all follow a specific naming scheme. For example, ``create_blend_state``, with triplets of methods that all follow a specific naming scheme.
``bind_blend_state``, and ``destroy_blend_state``. For example, ``create_blend_state``, ``bind_blend_state``, and
``destroy_blend_state``.
CSO objects handled by the context object: CSO objects handled by the context object:
* :ref:`Blend`: ``*_blend_state`` * :ref:`Blend`: ``*_blend_state``
* :ref:`Sampler`: These are special; they can be bound to either vertex or * :ref:`Sampler`: Texture sampler states are bound separately for fragment,
fragment samplers, and they are bound in groups. vertex and geometry samplers. Note that sampler states are set en masse.
``bind_fragment_sampler_states``, ``bind_vertex_sampler_states`` If M is the max number of sampler units supported by the driver and N
samplers are bound with ``bind_fragment_sampler_states`` then sampler
units N..M-1 are considered disabled/NULL.
* :ref:`Rasterizer`: ``*_rasterizer_state`` * :ref:`Rasterizer`: ``*_rasterizer_state``
* :ref:`Depth, Stencil, & Alpha`: ``*_depth_stencil_alpha_state`` * :ref:`Depth, Stencil, & Alpha`: ``*_depth_stencil_alpha_state``
* :ref:`Shader`: These have two sets of methods. ``*_fs_state`` is for * :ref:`Shader`: These are create, bind and destroy methods for vertex,
fragment shaders, and ``*_vs_state`` is for vertex shaders. fragment and geometry shaders.
* :ref:`Vertex Elements`: ``*_vertex_elements_state`` * :ref:`Vertex Elements`: ``*_vertex_elements_state``
@@ -47,6 +54,9 @@ buffers, surfaces) are bound to the driver.
* ``set_index_buffer`` * ``set_index_buffer``
* ``set_stream_output_buffers``
Non-CSO State Non-CSO State
^^^^^^^^^^^^^ ^^^^^^^^^^^^^
@@ -96,7 +106,9 @@ to the array index which is used for sampling.
* ``set_fragment_sampler_views`` binds an array of sampler views to * ``set_fragment_sampler_views`` binds an array of sampler views to
fragment shader stage. Every binding point acquires a reference fragment shader stage. Every binding point acquires a reference
to a respective sampler view and releases a reference to the previous to a respective sampler view and releases a reference to the previous
sampler view. sampler view. If M is the maximum number of sampler units and N units
is passed to set_fragment_sampler_views, the driver should unbind the
sampler views for units N..M-1.
* ``set_vertex_sampler_views`` binds an array of sampler views to vertex * ``set_vertex_sampler_views`` binds an array of sampler views to vertex
shader stage. Every binding point acquires a reference to a respective shader stage. Every binding point acquires a reference to a respective