2009-12-20 19:41:50 -08:00
|
|
|
.. _sampler:
|
|
|
|
|
2009-12-20 15:00:40 -08:00
|
|
|
Sampler
|
|
|
|
=======
|
|
|
|
|
|
|
|
Texture units have many options for selecting texels from loaded textures;
|
|
|
|
this state controls an individual texture unit's texel-sampling settings.
|
|
|
|
|
2009-12-20 16:40:39 -08:00
|
|
|
Texture coordinates are always treated as four-dimensional, and referred to
|
|
|
|
with the traditional (S, T, R, Q) notation.
|
|
|
|
|
2009-12-20 15:00:40 -08:00
|
|
|
Members
|
|
|
|
-------
|
|
|
|
|
2009-12-20 16:40:39 -08:00
|
|
|
XXX undocumented compare_mode, compare_func
|
|
|
|
|
|
|
|
wrap_s
|
|
|
|
How to wrap the S coordinate. One of PIPE_TEX_WRAP.
|
|
|
|
wrap_t
|
|
|
|
How to wrap the T coordinate. One of PIPE_TEX_WRAP.
|
|
|
|
wrap_r
|
|
|
|
How to wrap the R coordinate. One of PIPE_TEX_WRAP.
|
|
|
|
min_img_filter
|
|
|
|
The filter to use when minifying texels. One of PIPE_TEX_FILTER.
|
|
|
|
min_mip_filter
|
|
|
|
The filter to use when minifying mipmapped textures. One of
|
|
|
|
PIPE_TEX_FILTER.
|
|
|
|
mag_img_filter
|
|
|
|
The filter to use when magnifying texels. One of PIPE_TEX_FILTER.
|
|
|
|
normalized_coords
|
|
|
|
Whether the texture coordinates are normalized. If normalized, they will
|
|
|
|
always be in [0, 1]. If not, they will be in the range of each dimension
|
|
|
|
of the loaded texture.
|
|
|
|
prefilter
|
|
|
|
XXX From the Doxy, "weird sampling state exposed by some APIs." Refine.
|
|
|
|
lod_bias
|
|
|
|
The bias to apply to the level of detail.
|
|
|
|
min_lod
|
|
|
|
Minimum level of detail, used to clamp LoD after bias.
|
|
|
|
max_lod
|
|
|
|
Maximum level of detail, used to clamp LoD after bias.
|
|
|
|
border_color
|
|
|
|
RGBA color used for out-of-bounds coordinates.
|
|
|
|
max_anisotropy
|
|
|
|
Maximum filtering to apply anisotropically to textures. Setting this to
|
|
|
|
1.0 effectively disables anisotropic filtering.
|