Commit 8c9b9aac authored by Marek Olšák's avatar Marek Olšák

gallium: change comments to remove 'state tracker'

Acked-by: Eric Anholt's avatarEric Anholt <eric@anholt.net>
Acked-by: Alyssa Rosenzweig's avatarAlyssa Rosenzweig <alyssa.rosenzweig@collabora.com>
Acked-by: Pierre-Eric Pelloux-Prayer's avatarPierre-Eric Pelloux-Prayer <pierre-eric.pelloux-prayer@amd.com>
Part-of: <!4902>
parent d6287a94
...@@ -430,7 +430,7 @@ Mesa EGL supports different sets of environment variables. See the ...@@ -430,7 +430,7 @@ Mesa EGL supports different sets of environment variables. See the
options.</dd> options.</dd>
</dl> </dl>
<h3>Clover state tracker environment variables</h3> <h3>Clover environment variables</h3>
<dl> <dl>
<dt><code>CLOVER_EXTRA_BUILD_OPTIONS</code></dt> <dt><code>CLOVER_EXTRA_BUILD_OPTIONS</code></dt>
...@@ -507,7 +507,7 @@ Mesa EGL supports different sets of environment variables. See the ...@@ -507,7 +507,7 @@ Mesa EGL supports different sets of environment variables. See the
<code>wglSwapIntervalEXT()</code> will have no effect.</dd> <code>wglSwapIntervalEXT()</code> will have no effect.</dd>
</dl> </dl>
<h3>VA-API state tracker environment variables</h3> <h3>VA-API environment variables</h3>
<dl> <dl>
<dt><code>VAAPI_MPEG4_ENABLED</code></dt> <dt><code>VAAPI_MPEG4_ENABLED</code></dt>
<dd>enable MPEG4 for VA-API, disabled by default.</dd> <dd>enable MPEG4 for VA-API, disabled by default.</dd>
......
...@@ -76,7 +76,7 @@ option( ...@@ -76,7 +76,7 @@ option(
type : 'combo', type : 'combo',
value : 'auto', value : 'auto',
choices : ['auto', 'true', 'false'], choices : ['auto', 'true', 'false'],
description : 'enable gallium vdpau state tracker.', description : 'enable gallium vdpau frontend.',
) )
option( option(
'vdpau-libs-path', 'vdpau-libs-path',
...@@ -89,7 +89,7 @@ option( ...@@ -89,7 +89,7 @@ option(
type : 'combo', type : 'combo',
value : 'auto', value : 'auto',
choices : ['auto', 'true', 'false'], choices : ['auto', 'true', 'false'],
description : 'enable gallium xvmc state tracker.', description : 'enable gallium xvmc frontend.',
) )
option( option(
'xvmc-libs-path', 'xvmc-libs-path',
...@@ -102,7 +102,7 @@ option( ...@@ -102,7 +102,7 @@ option(
type : 'combo', type : 'combo',
value : 'auto', value : 'auto',
choices : ['auto', 'disabled', 'bellagio', 'tizonia'], choices : ['auto', 'disabled', 'bellagio', 'tizonia'],
description : 'enable gallium omx state tracker.', description : 'enable gallium omx frontend.',
) )
option( option(
'omx-libs-path', 'omx-libs-path',
...@@ -115,7 +115,7 @@ option( ...@@ -115,7 +115,7 @@ option(
type : 'combo', type : 'combo',
value : 'auto', value : 'auto',
choices : ['auto', 'true', 'false'], choices : ['auto', 'true', 'false'],
description : 'enable gallium va state tracker.', description : 'enable gallium va frontend.',
) )
option( option(
'va-libs-path', 'va-libs-path',
...@@ -128,26 +128,26 @@ option( ...@@ -128,26 +128,26 @@ option(
type : 'combo', type : 'combo',
value : 'auto', value : 'auto',
choices : ['auto', 'true', 'false'], choices : ['auto', 'true', 'false'],
description : 'enable gallium xa state tracker.', description : 'enable gallium xa frontend.',
) )
option( option(
'gallium-nine', 'gallium-nine',
type : 'boolean', type : 'boolean',
value : false, value : false,
description : 'build gallium "nine" Direct3D 9.x state tracker.', description : 'build gallium "nine" Direct3D 9.x frontend.',
) )
option( option(
'gallium-opencl', 'gallium-opencl',
type : 'combo', type : 'combo',
choices : ['icd', 'standalone', 'disabled'], choices : ['icd', 'standalone', 'disabled'],
value : 'disabled', value : 'disabled',
description : 'build gallium "clover" OpenCL state tracker.', description : 'build gallium "clover" OpenCL frontend.',
) )
option( option(
'opencl-spirv', 'opencl-spirv',
type : 'boolean', type : 'boolean',
value : false, value : false,
description : 'build gallium "clover" OpenCL state tracker with SPIR-V binary support.', description : 'build gallium "clover" OpenCL frontend with SPIR-V binary support.',
) )
option( option(
'd3d-drivers-path', 'd3d-drivers-path',
......
...@@ -3,7 +3,7 @@ ...@@ -3,7 +3,7 @@
= General Considerations = = General Considerations =
The state tracker and winsys driver support a rather limited number of The frontend and winsys driver support a rather limited number of
platforms. However, the pipe drivers are meant to run in a wide number of platforms. However, the pipe drivers are meant to run in a wide number of
platforms. Hence the pipe drivers, the auxiliary modules, and all public platforms. Hence the pipe drivers, the auxiliary modules, and all public
headers in general, should strictly follow these guidelines to ensure headers in general, should strictly follow these guidelines to ensure
......
...@@ -39,7 +39,7 @@ if env['platform'] == 'windows': ...@@ -39,7 +39,7 @@ if env['platform'] == 'windows':
# #
# State trackers and targets # Frontends and targets
# #
if not env['embedded']: if not env['embedded']:
......
...@@ -71,7 +71,7 @@ cso_set_samplers(struct cso_context *cso, ...@@ -71,7 +71,7 @@ cso_set_samplers(struct cso_context *cso,
const struct pipe_sampler_state **states); const struct pipe_sampler_state **states);
/* Alternate interface to support state trackers that like to modify /* Alternate interface to support gallium frontends that like to modify
* samplers one at a time: * samplers one at a time:
*/ */
void void
...@@ -100,7 +100,7 @@ void cso_set_stream_outputs(struct cso_context *ctx, ...@@ -100,7 +100,7 @@ void cso_set_stream_outputs(struct cso_context *ctx,
* We don't provide shader caching in CSO. Most of the time the api provides * We don't provide shader caching in CSO. Most of the time the api provides
* object semantics for shaders anyway, and the cases where it doesn't * object semantics for shaders anyway, and the cases where it doesn't
* (eg mesa's internally-generated texenv programs), it will be up to * (eg mesa's internally-generated texenv programs), it will be up to
* the state tracker to implement their own specialized caching. * gallium frontends to implement their own specialized caching.
*/ */
void cso_set_fragment_shader_handle(struct cso_context *ctx, void *handle); void cso_set_fragment_shader_handle(struct cso_context *ctx, void *handle);
......
...@@ -633,7 +633,7 @@ aaline_stage_from_pipe(struct pipe_context *pipe) ...@@ -633,7 +633,7 @@ aaline_stage_from_pipe(struct pipe_context *pipe)
/** /**
* This function overrides the driver's create_fs_state() function and * This function overrides the driver's create_fs_state() function and
* will typically be called by the state tracker. * will typically be called by the gallium frontend.
*/ */
static void * static void *
aaline_create_fs_state(struct pipe_context *pipe, aaline_create_fs_state(struct pipe_context *pipe,
......
...@@ -734,7 +734,7 @@ aapoint_stage_from_pipe(struct pipe_context *pipe) ...@@ -734,7 +734,7 @@ aapoint_stage_from_pipe(struct pipe_context *pipe)
/** /**
* This function overrides the driver's create_fs_state() function and * This function overrides the driver's create_fs_state() function and
* will typically be called by the state tracker. * will typically be called by the gallium frontend.
*/ */
static void * static void *
aapoint_create_fs_state(struct pipe_context *pipe, aapoint_create_fs_state(struct pipe_context *pipe,
......
...@@ -334,7 +334,7 @@ pstip_stage_from_pipe(struct pipe_context *pipe) ...@@ -334,7 +334,7 @@ pstip_stage_from_pipe(struct pipe_context *pipe)
/** /**
* This function overrides the driver's create_fs_state() function and * This function overrides the driver's create_fs_state() function and
* will typically be called by the state tracker. * will typically be called by the gallium frontend.
*/ */
static void * static void *
pstip_create_fs_state(struct pipe_context *pipe, pstip_create_fs_state(struct pipe_context *pipe,
......
...@@ -47,7 +47,7 @@ ...@@ -47,7 +47,7 @@
* that varies .x from 0 to 1 horizontally across the point and varies .y * that varies .x from 0 to 1 horizontally across the point and varies .y
* vertically from 0 to 1 down the sprite. * vertically from 0 to 1 down the sprite.
* *
* With geometry shaders, the state tracker could create a GS to do * With geometry shaders, the gallium frontends could create a GS to do
* most/all of this. * most/all of this.
*/ */
......
...@@ -425,7 +425,7 @@ draw_pt_arrays_restart(struct draw_context *draw, ...@@ -425,7 +425,7 @@ draw_pt_arrays_restart(struct draw_context *draw,
} }
else { else {
/* Non-indexed prims (draw_arrays). /* Non-indexed prims (draw_arrays).
* Primitive restart should have been handled in the state tracker. * Primitive restart should have been handled in gallium frontends.
*/ */
draw_pt_arrays(draw, prim, start, count); draw_pt_arrays(draw, prim, start, count);
} }
...@@ -556,7 +556,7 @@ draw_vbo(struct draw_context *draw, ...@@ -556,7 +556,7 @@ draw_vbo(struct draw_context *draw,
/* /*
* TODO: We could use draw->pt.max_index to further narrow * TODO: We could use draw->pt.max_index to further narrow
* the min_index/max_index hints given by the state tracker. * the min_index/max_index hints given by gallium frontends.
*/ */
for (instance = 0; instance < info->instance_count; instance++) { for (instance = 0; instance < info->instance_count; instance++) {
......
...@@ -40,7 +40,7 @@ ...@@ -40,7 +40,7 @@
* TGSI translation limits. * TGSI translation limits.
* *
* Some are slightly above SM 3.0 requirements to give some wiggle room to * Some are slightly above SM 3.0 requirements to give some wiggle room to
* the state trackers. * the gallium frontends.
*/ */
#define LP_MAX_TGSI_TEMPS 4096 #define LP_MAX_TGSI_TEMPS 4096
......
...@@ -143,11 +143,11 @@ static void init_native_targets() ...@@ -143,11 +143,11 @@ static void init_native_targets()
extern "C" void extern "C" void
lp_set_target_options(void) lp_set_target_options(void)
{ {
/* The llvm target registry is not thread-safe, so drivers and state-trackers /* The llvm target registry is not thread-safe, so drivers and gallium frontends
* that want to initialize targets should use the lp_set_target_options() * that want to initialize targets should use the lp_set_target_options()
* function to safely initialize targets. * function to safely initialize targets.
* *
* LLVM targets should be initialized before the driver or state-tracker tries * LLVM targets should be initialized before the driver or gallium frontend tries
* to access the registry. * to access the registry.
*/ */
call_once(&init_native_targets_once_flag, init_native_targets); call_once(&init_native_targets_once_flag, init_native_targets);
......
...@@ -179,7 +179,7 @@ lp_sampler_static_sampler_state(struct lp_static_sampler_state *state, ...@@ -179,7 +179,7 @@ lp_sampler_static_sampler_state(struct lp_static_sampler_state *state,
* spurious recompiles, as the sampler static state is part of the shader * spurious recompiles, as the sampler static state is part of the shader
* key. * key.
* *
* Ideally the state tracker or cso_cache module would make all state * Ideally gallium frontends or cso_cache module would make all state
* canonical, but until that happens it's better to be safe than sorry here. * canonical, but until that happens it's better to be safe than sorry here.
* *
* XXX: Actually there's much more than can be done here, especially * XXX: Actually there's much more than can be done here, especially
......
...@@ -3124,7 +3124,7 @@ lp_build_sample_soa_code(struct gallivm_state *gallivm, ...@@ -3124,7 +3124,7 @@ lp_build_sample_soa_code(struct gallivm_state *gallivm,
* here which would say it's pure int despite such formats should sample * here which would say it's pure int despite such formats should sample
* the depth component). * the depth component).
* In GL such filters make the texture incomplete, this makes it robust * In GL such filters make the texture incomplete, this makes it robust
* against state trackers which set this up regardless (we'd crash in the * against gallium frontends which set this up regardless (we'd crash in the
* lerp later otherwise). * lerp later otherwise).
* At least in some apis it may be legal to use such filters with lod * At least in some apis it may be legal to use such filters with lod
* queries and/or gather (at least for gather d3d10 says only the wrap * queries and/or gather (at least for gather d3d10 says only the wrap
......
...@@ -27,7 +27,7 @@ ...@@ -27,7 +27,7 @@
/* This head-up display module can draw transparent graphs on top of what /* This head-up display module can draw transparent graphs on top of what
* the app is rendering, visualizing various data like framerate, cpu load, * the app is rendering, visualizing various data like framerate, cpu load,
* performance counters, etc. It can be hook up into any state tracker. * performance counters, etc. It can be hook up into any gallium frontend.
* *
* The HUD is controlled with the GALLIUM_HUD environment variable. * The HUD is controlled with the GALLIUM_HUD environment variable.
* Set GALLIUM_HUD=help for more info. * Set GALLIUM_HUD=help for more info.
......
...@@ -107,7 +107,7 @@ util_draw_max_index( ...@@ -107,7 +107,7 @@ util_draw_max_index(
max_index = MIN2(max_index, buffer_max_index); max_index = MIN2(max_index, buffer_max_index);
} }
else { else {
/* Per-instance data. Simply make sure the state tracker didn't /* Per-instance data. Simply make sure gallium frontends didn't
* request more instances than those that fit in the buffer */ * request more instances than those that fit in the buffer */
if ((info->start_instance + info->instance_count)/element->instance_divisor if ((info->start_instance + info->instance_count)/element->instance_divisor
> (buffer_max_index + 1)) { > (buffer_max_index + 1)) {
......
...@@ -165,7 +165,7 @@ util_upload_index_buffer(struct pipe_context *pipe, ...@@ -165,7 +165,7 @@ util_upload_index_buffer(struct pipe_context *pipe,
* CPU cores that share the same L3 cache. This is needed for good multi- * CPU cores that share the same L3 cache. This is needed for good multi-
* threading performance on AMD Zen CPUs. * threading performance on AMD Zen CPUs.
* *
* \param upper_thread thread in the state tracker that also needs to be * \param upper_thread thread in gallium frontends that also needs to be
* pinned. * pinned.
*/ */
void void
......
...@@ -111,7 +111,7 @@ u_pipe_screen_get_param_defaults(struct pipe_screen *pscreen, ...@@ -111,7 +111,7 @@ u_pipe_screen_get_param_defaults(struct pipe_screen *pscreen,
return 120; return 120;
case PIPE_CAP_ESSL_FEATURE_LEVEL: case PIPE_CAP_ESSL_FEATURE_LEVEL:
/* Tell state-tracker to fallback to PIPE_CAP_GLSL_FEATURE_LEVEL */ /* Tell gallium frontend to fallback to PIPE_CAP_GLSL_FEATURE_LEVEL */
return 0; return 0;
case PIPE_CAP_QUADS_FOLLOW_PROVOKING_VERTEX_CONVENTION: case PIPE_CAP_QUADS_FOLLOW_PROVOKING_VERTEX_CONVENTION:
......
...@@ -238,7 +238,7 @@ threaded_context_flush(struct pipe_context *_pipe, ...@@ -238,7 +238,7 @@ threaded_context_flush(struct pipe_context *_pipe,
{ {
struct threaded_context *tc = threaded_context(_pipe); struct threaded_context *tc = threaded_context(_pipe);
/* This is called from the state-tracker / application thread. */ /* This is called from the gallium frontend / application thread. */
if (token->tc && token->tc == tc) { if (token->tc && token->tc == tc) {
struct tc_batch *last = &tc->batch_slots[tc->last]; struct tc_batch *last = &tc->batch_slots[tc->last];
......
...@@ -27,7 +27,7 @@ ...@@ -27,7 +27,7 @@
/** /**
* RGBA/float tile get/put functions. * RGBA/float tile get/put functions.
* Usable both by drivers and state trackers. * Usable both by drivers and gallium frontends.
*/ */
......
...@@ -82,7 +82,7 @@ struct u_transfer_vtbl { ...@@ -82,7 +82,7 @@ struct u_transfer_vtbl {
* Must be implemented if separate stencil or fake_rgtc is used. The * Must be implemented if separate stencil or fake_rgtc is used. The
* internal_format is the format the resource was created with. In * internal_format is the format the resource was created with. In
* the case of separate stencil or fake_rgtc, prsc->format is set back * the case of separate stencil or fake_rgtc, prsc->format is set back
* to the state tracker visible format (e.g. Z32_FLOAT_S8X24_UINT or * to the gallium-frontend-visible format (e.g. Z32_FLOAT_S8X24_UINT or
* PIPE_FORMAT_{RTGC,LATC}* after the resource is created. * PIPE_FORMAT_{RTGC,LATC}* after the resource is created.
*/ */
enum pipe_format (*get_internal_format)(struct pipe_resource *prsc); enum pipe_format (*get_internal_format)(struct pipe_resource *prsc);
......
...@@ -382,7 +382,7 @@ Queries ...@@ -382,7 +382,7 @@ Queries
^^^^^^^ ^^^^^^^
Queries gather some statistic from the 3D pipeline over one or more Queries gather some statistic from the 3D pipeline over one or more
draws. Queries may be nested, though not all state trackers exercise this. draws. Queries may be nested, though not all gallium frontends exercise this.
Queries can be created with ``create_query`` and deleted with Queries can be created with ``create_query`` and deleted with
``destroy_query``. To start a query, use ``begin_query``, and when finished, ``destroy_query``. To start a query, use ``begin_query``, and when finished,
...@@ -856,7 +856,7 @@ for particular texture types or formats. ...@@ -856,7 +856,7 @@ for particular texture types or formats.
Device resets Device resets
^^^^^^^^^^^^^ ^^^^^^^^^^^^^
The state tracker can query or request notifications of when the GPU Gallium frontends can query or request notifications of when the GPU
is reset for whatever reason (application error, driver error). When is reset for whatever reason (application error, driver error). When
a GPU reset happens, the context becomes unusable and all related state a GPU reset happens, the context becomes unusable and all related state
should be considered lost and undefined. Despite that, context should be considered lost and undefined. Despite that, context
......
...@@ -21,7 +21,7 @@ OpenGL: glClampColor(GL_CLAMP_VERTEX_COLOR) in GL 3.0 or GL_ARB_color_buffer_flo ...@@ -21,7 +21,7 @@ OpenGL: glClampColor(GL_CLAMP_VERTEX_COLOR) in GL 3.0 or GL_ARB_color_buffer_flo
D3D11: seems always disabled D3D11: seems always disabled
Note the PIPE_CAP_VERTEX_COLOR_CLAMPED query indicates whether or not the Note the PIPE_CAP_VERTEX_COLOR_CLAMPED query indicates whether or not the
driver supports this control. If it's not supported, the state tracker may driver supports this control. If it's not supported, gallium frontends may
have to insert extra clamping code. have to insert extra clamping code.
...@@ -36,7 +36,7 @@ OpenGL: glClampColor(GL_CLAMP_FRAGMENT_COLOR) in GL 3.0 or ARB_color_buffer_floa ...@@ -36,7 +36,7 @@ OpenGL: glClampColor(GL_CLAMP_FRAGMENT_COLOR) in GL 3.0 or ARB_color_buffer_floa
D3D11: seems always disabled D3D11: seems always disabled
Note the PIPE_CAP_FRAGMENT_COLOR_CLAMPED query indicates whether or not the Note the PIPE_CAP_FRAGMENT_COLOR_CLAMPED query indicates whether or not the
driver supports this control. If it's not supported, the state tracker may driver supports this control. If it's not supported, gallium frontends may
have to insert extra clamping code. have to insert extra clamping code.
...@@ -184,7 +184,7 @@ the state of 'sprite_coord_mode' (see below). ...@@ -184,7 +184,7 @@ the state of 'sprite_coord_mode' (see below).
If any bit is set, then point_smooth MUST be disabled (there are no If any bit is set, then point_smooth MUST be disabled (there are no
round sprites) and point_quad_rasterization MUST be true (sprites are round sprites) and point_quad_rasterization MUST be true (sprites are
always rasterized as quads). Any mismatch between these states should always rasterized as quads). Any mismatch between these states should
be considered a bug in the state-tracker. be considered a bug in the gallium frontend.
This feature is implemented in the :ref:`Draw` module but may also be This feature is implemented in the :ref:`Draw` module but may also be
implemented natively by GPUs or implemented with a geometry shader. implemented natively by GPUs or implemented with a geometry shader.
......
...@@ -46,8 +46,8 @@ the shader sanity checker prints its warnings and errors to stderr. ...@@ -46,8 +46,8 @@ the shader sanity checker prints its warnings and errors to stderr.
Whether the :ref:`Draw` module will attempt to use LLVM for vertex and geometry shaders. Whether the :ref:`Draw` module will attempt to use LLVM for vertex and geometry shaders.
State tracker-specific GL State tracker-specific
"""""""""""""""""""""" """""""""""""""""""""""""
.. envvar:: ST_DEBUG <flags> (0x0) .. envvar:: ST_DEBUG <flags> (0x0)
......
Distribution Distribution
============ ============
Along with the interface definitions, the following drivers, state trackers, Along with the interface definitions, the following drivers, gallium frontends,
and auxiliary modules are shipped in the standard Gallium distribution. and auxiliary modules are shipped in the standard Gallium distribution.
Drivers Drivers
...@@ -78,8 +78,8 @@ Rbug ...@@ -78,8 +78,8 @@ Rbug
Wrapper driver. :ref:`rbug` driver used with stand alone rbug-gui. Wrapper driver. :ref:`rbug` driver used with stand alone rbug-gui.
State Trackers Gallium frontends
-------------- -----------------
Clover Clover
^^^^^^ ^^^^^^
...@@ -101,9 +101,9 @@ GLX ...@@ -101,9 +101,9 @@ GLX
MesaGL MesaGL
^^^^^^ ^^^^^^
Tracker implementing a GL state machine. Not usable as a standalone tracker; The gallium frontend implementing a GL state machine. Not usable as
Mesa should be built with another state tracker, such as :ref:`DRI` or a standalone frontend; Mesa should be built with another gallium frontend,
:ref:`EGL`. such as :ref:`DRI` or :ref:`EGL`.
VDPAU VDPAU
^^^^^ ^^^^^
......
...@@ -85,7 +85,7 @@ The integer capabilities: ...@@ -85,7 +85,7 @@ The integer capabilities:
per-instance vertex attribs. per-instance vertex attribs.
* ``PIPE_CAP_FRAGMENT_COLOR_CLAMPED``: Whether fragment color clamping is * ``PIPE_CAP_FRAGMENT_COLOR_CLAMPED``: Whether fragment color clamping is
supported. That is, is the pipe_rasterizer_state::clamp_fragment_color supported. That is, is the pipe_rasterizer_state::clamp_fragment_color
flag supported by the driver? If not, the state tracker will insert flag supported by the driver? If not, gallium frontends will insert
clamping code into the fragment shaders when needed. clamping code into the fragment shaders when needed.
* ``PIPE_CAP_MIXED_COLORBUFFER_FORMATS``: Whether mixed colorbuffer formats are * ``PIPE_CAP_MIXED_COLORBUFFER_FORMATS``: Whether mixed colorbuffer formats are
...@@ -99,7 +99,7 @@ The integer capabilities: ...@@ -99,7 +99,7 @@ The integer capabilities:
the vertex colors are never clamped. This is the default for DX10 hardware. the vertex colors are never clamped. This is the default for DX10 hardware.
If both clamped and unclamped CAPs are supported, the clamping can be If both clamped and unclamped CAPs are supported, the clamping can be
controlled through pipe_rasterizer_state. If the driver cannot do vertex controlled through pipe_rasterizer_state. If the driver cannot do vertex
color clamping, the state tracker may insert clamping code into the vertex color clamping, gallium frontends may insert clamping code into the vertex