gallium: change comments to remove 'state tracker'
authorMarek Olšák <marek.olsak@amd.com>
Wed, 4 Dec 2019 01:38:14 +0000 (20:38 -0500)
committerMarek Olšák <marek.olsak@amd.com>
Wed, 13 May 2020 17:47:27 +0000 (13:47 -0400)
Acked-by: Eric Anholt <eric@anholt.net>
Acked-by: Alyssa Rosenzweig <alyssa.rosenzweig@collabora.com>
Acked-by: Pierre-Eric Pelloux-Prayer <pierre-eric.pelloux-prayer@amd.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4902>

97 files changed:
docs/envvars.html
meson_options.txt
src/gallium/README.portability
src/gallium/SConscript
src/gallium/auxiliary/cso_cache/cso_context.h
src/gallium/auxiliary/draw/draw_pipe_aaline.c
src/gallium/auxiliary/draw/draw_pipe_aapoint.c
src/gallium/auxiliary/draw/draw_pipe_pstipple.c
src/gallium/auxiliary/draw/draw_pipe_wide_point.c
src/gallium/auxiliary/draw/draw_pt.c
src/gallium/auxiliary/gallivm/lp_bld_limits.h
src/gallium/auxiliary/gallivm/lp_bld_misc.cpp
src/gallium/auxiliary/gallivm/lp_bld_sample.c
src/gallium/auxiliary/gallivm/lp_bld_sample_soa.c
src/gallium/auxiliary/hud/hud_context.c
src/gallium/auxiliary/util/u_draw.c
src/gallium/auxiliary/util/u_helpers.c
src/gallium/auxiliary/util/u_screen.c
src/gallium/auxiliary/util/u_threaded_context.c
src/gallium/auxiliary/util/u_tile.c
src/gallium/auxiliary/util/u_transfer_helper.h
src/gallium/docs/source/context.rst
src/gallium/docs/source/cso/rasterizer.rst
src/gallium/docs/source/debugging.rst
src/gallium/docs/source/distro.rst
src/gallium/docs/source/screen.rst
src/gallium/docs/source/tgsi.rst
src/gallium/drivers/etnaviv/etnaviv_context.c
src/gallium/drivers/etnaviv/etnaviv_state.c
src/gallium/drivers/freedreno/freedreno_context.c
src/gallium/drivers/freedreno/freedreno_resource.c
src/gallium/drivers/freedreno/freedreno_state.c
src/gallium/drivers/i915/i915_state.c
src/gallium/drivers/iris/iris_batch.c
src/gallium/drivers/iris/iris_formats.c
src/gallium/drivers/iris/iris_state.c
src/gallium/drivers/llvmpipe/lp_setup.c
src/gallium/drivers/llvmpipe/lp_state_derived.c
src/gallium/drivers/llvmpipe/lp_state_sampler.c
src/gallium/drivers/llvmpipe/lp_texture.c
src/gallium/drivers/nouveau/nvc0/nvc0_screen.c
src/gallium/drivers/panfrost/pan_job.c
src/gallium/drivers/panfrost/pan_mfbd.c
src/gallium/drivers/panfrost/pan_resource.c
src/gallium/drivers/panfrost/pan_screen.c
src/gallium/drivers/r300/r300_context.c
src/gallium/drivers/r300/r300_context.h
src/gallium/drivers/r300/r300_render.c
src/gallium/drivers/r600/r600_pipe_common.c
src/gallium/drivers/r600/r600_state_common.c
src/gallium/drivers/radeonsi/si_fence.c
src/gallium/drivers/radeonsi/si_gfx_cs.c
src/gallium/drivers/radeonsi/si_pipe.c
src/gallium/drivers/radeonsi/si_shader_nir.c
src/gallium/drivers/radeonsi/si_state.c
src/gallium/drivers/radeonsi/si_texture.c
src/gallium/drivers/softpipe/sp_context.h
src/gallium/drivers/softpipe/sp_screen.c
src/gallium/drivers/softpipe/sp_state_derived.c
src/gallium/drivers/softpipe/sp_tex_sample.c
src/gallium/drivers/svga/svga_context.h
src/gallium/drivers/svga/svga_pipe_blit.c
src/gallium/drivers/svga/svga_pipe_misc.c
src/gallium/drivers/svga/svga_resource_buffer.c
src/gallium/drivers/svga/svga_resource_texture.c
src/gallium/drivers/svga/svga_screen.c
src/gallium/drivers/svga/svga_winsys.h
src/gallium/drivers/swr/swr_screen.cpp
src/gallium/drivers/v3d/v3dx_state.c
src/gallium/drivers/vc4/vc4_state.c
src/gallium/drivers/virgl/virgl_screen.c
src/gallium/frontends/clover/core/object.hpp
src/gallium/frontends/dri/dri2.c
src/gallium/frontends/dri/dri_drawable.c
src/gallium/frontends/dri/dri_screen.c
src/gallium/frontends/glx/xlib/xm_public.h
src/gallium/frontends/hgl/hgl_context.h
src/gallium/frontends/nine/swapchain9.c
src/gallium/frontends/osmesa/osmesa.c
src/gallium/frontends/vdpau/surface.c
src/gallium/frontends/vdpau/vdpau_private.h
src/gallium/frontends/wgl/stw_pixelformat.c
src/gallium/frontends/wgl/stw_st.c
src/gallium/frontends/wgl/stw_wgl.c
src/gallium/include/frontend/api.h
src/gallium/include/frontend/xlibsw_api.h
src/gallium/include/pipe/p_context.h
src/gallium/include/pipe/p_defines.h
src/gallium/include/pipe/p_screen.h
src/gallium/include/pipe/p_state.h
src/gallium/include/pipe/p_video_codec.h
src/gallium/targets/libgl-gdi/libgl_gdi.c
src/gallium/tools/trace/README.txt
src/mesa/state_tracker/st_cb_viewport.c
src/mesa/state_tracker/st_manager.c
src/panfrost/encoder/pan_afbc.c
src/util/merge_driinfo.py

index 0bf95a128436aa9b3bae79af81d84b592a475206..a642daf59c2ad6e1b1013e2dcef8a2c2eed09db4 100644 (file)
@@ -430,7 +430,7 @@ Mesa EGL supports different sets of environment variables.  See the
     options.</dd>
 </dl>
 
-<h3>Clover state tracker environment variables</h3>
+<h3>Clover environment variables</h3>
 
 <dl>
 <dt><code>CLOVER_EXTRA_BUILD_OPTIONS</code></dt>
@@ -507,7 +507,7 @@ Mesa EGL supports different sets of environment variables.  See the
     <code>wglSwapIntervalEXT()</code> will have no effect.</dd>
 </dl>
 
-<h3>VA-API state tracker environment variables</h3>
+<h3>VA-API environment variables</h3>
 <dl>
 <dt><code>VAAPI_MPEG4_ENABLED</code></dt>
 <dd>enable MPEG4 for VA-API, disabled by default.</dd>
index ab43150669bf08749bc004147e99cd8c834474fb..f5609cacc51754e8a43b8aedb1a4b07895d241e6 100644 (file)
@@ -76,7 +76,7 @@ option(
   type : 'combo',
   value : 'auto',
   choices : ['auto', 'true', 'false'],
-  description : 'enable gallium vdpau state tracker.',
+  description : 'enable gallium vdpau frontend.',
 )
 option(
   'vdpau-libs-path',
@@ -89,7 +89,7 @@ option(
   type : 'combo',
   value : 'auto',
   choices : ['auto', 'true', 'false'],
-  description : 'enable gallium xvmc state tracker.',
+  description : 'enable gallium xvmc frontend.',
 )
 option(
   'xvmc-libs-path',
@@ -102,7 +102,7 @@ option(
   type : 'combo',
   value : 'auto',
   choices : ['auto', 'disabled', 'bellagio', 'tizonia'],
-  description : 'enable gallium omx state tracker.',
+  description : 'enable gallium omx frontend.',
 )
 option(
   'omx-libs-path',
@@ -115,7 +115,7 @@ option(
   type : 'combo',
   value : 'auto',
   choices : ['auto', 'true', 'false'],
-  description : 'enable gallium va state tracker.',
+  description : 'enable gallium va frontend.',
 )
 option(
   'va-libs-path',
@@ -128,26 +128,26 @@ option(
   type : 'combo',
   value : 'auto',
   choices : ['auto', 'true', 'false'],
-  description : 'enable gallium xa state tracker.',
+  description : 'enable gallium xa frontend.',
 )
 option(
   'gallium-nine',
   type : 'boolean',
   value : false,
-  description : 'build gallium "nine" Direct3D 9.x state tracker.',
+  description : 'build gallium "nine" Direct3D 9.x frontend.',
 )
 option(
   'gallium-opencl',
   type : 'combo',
   choices : ['icd', 'standalone', 'disabled'],
   value : 'disabled',
-  description : 'build gallium "clover" OpenCL state tracker.',
+  description : 'build gallium "clover" OpenCL frontend.',
 )
 option(
   'opencl-spirv',
   type : 'boolean',
   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(
   'd3d-drivers-path',
index cf6cc36afbb6a431b67ff6719a75b3859f06c736..9fbec4c5f5cd7c87f8f970db55b7904007e47e8b 100644 (file)
@@ -3,7 +3,7 @@
 
 = 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. Hence the pipe drivers, the auxiliary modules, and all public
 headers in general, should strictly follow these guidelines to ensure
index 5017d5fe24773d4835f4aac455936fb1ae1c4234..98ba88588d54d516570f31c124fa42f407d5edf7 100644 (file)
@@ -39,7 +39,7 @@ if env['platform'] == 'windows':
 
 
 #
-# State trackers and targets
+# Frontends and targets
 #
 
 if not env['embedded']:
index ce64568a6dadd0da8a9ee06cc4a647e00931314a..95df3c169d7fe6e69474912ca51c4324b80e836e 100644 (file)
@@ -71,7 +71,7 @@ cso_set_samplers(struct cso_context *cso,
                  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:
  */
 void
@@ -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
  * object semantics for shaders anyway, and the cases where it doesn't
  * (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);
index cd4be6d967fbec8aefd5f6b197567836b0b554d6..d380b4295d4721e51152f7c3335ed06f392d4df0 100644 (file)
@@ -633,7 +633,7 @@ aaline_stage_from_pipe(struct pipe_context *pipe)
 
 /**
  * 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 *
 aaline_create_fs_state(struct pipe_context *pipe,
index 2ee2bc17faa08f05537a424bd57fae6e4fac614e..2df5bf1a6f394cac1b311c01596ed8a7cbb32529 100644 (file)
@@ -734,7 +734,7 @@ aapoint_stage_from_pipe(struct pipe_context *pipe)
 
 /**
  * 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 *
 aapoint_create_fs_state(struct pipe_context *pipe,
index bd74cb42adaebac368d96232db07929e17a099d6..dbb0545a9ac0a9a8c82f0dcbf3d1e2b0f2593cd0 100644 (file)
@@ -334,7 +334,7 @@ pstip_stage_from_pipe(struct pipe_context *pipe)
 
 /**
  * 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 *
 pstip_create_fs_state(struct pipe_context *pipe,
index e9bbb67a95838cd7c948a2e2bf8b0b66cf30f1ca..2f2c1072540f6dcbf4a55628f5877a86fa9cb761 100644 (file)
@@ -47,7 +47,7 @@
  * that varies .x from 0 to 1 horizontally across the point and varies .y
  * 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.
  */
 
index 986f87e015282031f5178d26f0d2c70ce7469e1f..0ea1f14c1e0eef159f0ba694209c91c22cb0ffd4 100644 (file)
@@ -425,7 +425,7 @@ draw_pt_arrays_restart(struct draw_context *draw,
    }
    else {
       /* 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);
    }
@@ -556,7 +556,7 @@ draw_vbo(struct draw_context *draw,
 
    /*
     * 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++) {
index 9d0a5ca92d196d611e1c60841996755a1072aeca..dea0c72c8a64319161f2f5d82faeeff28e119819 100644 (file)
@@ -40,7 +40,7 @@
  * TGSI translation limits.
  *
  * 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
index df7196190c5ea03de5c9d372fd74ea83c9e7400b..b079b96b6deafb80fb530699e92d616534d3d97c 100644 (file)
@@ -143,11 +143,11 @@ static void init_native_targets()
 extern "C" 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()
     * 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.
     */
    call_once(&init_native_targets_once_flag, init_native_targets);
index fa145e1c3b292dc6356304dee4fb68d5a9de5965..8e453580b16e8a775d8579fda086d3ef2baefa41 100644 (file)
@@ -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
     * 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.
     *
     * XXX: Actually there's much more than can be done here, especially
index 5b623eda26bd19408353c678c1751b3a70b9f8d6..79f569baf9327e79a8684a12015238420dfec537 100644 (file)
@@ -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
        * the depth component).
        * 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).
        * 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
index 1e2b948e3489b021b042b7e8d031b613e2c7126b..0cd3307a1a5f7cd01d25ddd9e98fdc85bf508198 100644 (file)
@@ -27,7 +27,7 @@
 
 /* This head-up display module can draw transparent graphs on top of what
  * 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.
  * Set GALLIUM_HUD=help for more info.
index a43938774bbc44996ddfda591d68ee81aed770cd..f4ac2b107a93a968c79da482977916bbfa75c4e7 100644 (file)
@@ -107,7 +107,7 @@ util_draw_max_index(
             max_index = MIN2(max_index, buffer_max_index);
          }
          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 */
             if ((info->start_instance + info->instance_count)/element->instance_divisor
                 > (buffer_max_index + 1)) {
index 31b7d533952d158ebef68ce6c28c478d4d384d0c..6fa3f1a1fcdfa166f5bd9e9dccd769148e96ebb7 100644 (file)
@@ -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-
  * 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.
  */
 void
index a7fb85ca27baba26b79b61b382b8fa003ce7f473..6b0a106a637f8a7ca595a8d50ff784005e2248f6 100644 (file)
@@ -111,7 +111,7 @@ u_pipe_screen_get_param_defaults(struct pipe_screen *pscreen,
       return 120;
 
    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;
 
    case PIPE_CAP_QUADS_FOLLOW_PROVOKING_VERTEX_CONVENTION:
index d8536af77be15b9af3320cb87b723222d413d7b9..9e835867ef3e754822e805dd30f2f8b3558eae62 100644 (file)
@@ -238,7 +238,7 @@ threaded_context_flush(struct pipe_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) {
       struct tc_batch *last = &tc->batch_slots[tc->last];
 
index d954301a961e9d27bcbb76e6b35b5f2a71afb636..add92ed81398c3cb4088a3b91b4e58fc673225e3 100644 (file)
@@ -27,7 +27,7 @@
 
 /**
  * RGBA/float tile get/put functions.
- * Usable both by drivers and state trackers.
+ * Usable both by drivers and gallium frontends.
  */
 
 
index 9e5f889f9d82f99ad9999a7953247e0d130a20d9..e27c35704999783407ddb1043f7a6dd4ba4c9687 100644 (file)
@@ -82,7 +82,7 @@ struct u_transfer_vtbl {
     * Must be implemented if separate stencil or fake_rgtc is used.  The
     * internal_format is the format the resource was created with.  In
     * 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.
     */
    enum pipe_format (*get_internal_format)(struct pipe_resource *prsc);
index 06d30bfb38b477c19a37c0d525bb282a6d691ba7..7f8111b2316de0dbe350bcccf6bad50d1e540db9 100644 (file)
@@ -382,7 +382,7 @@ Queries
 ^^^^^^^
 
 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
 ``destroy_query``. To start a query, use ``begin_query``, and when finished,
@@ -856,7 +856,7 @@ for particular texture types or formats.
 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
 a GPU reset happens, the context becomes unusable and all related state
 should be considered lost and undefined. Despite that, context
index 4dabcc032f504394de4ac2034b1d2bfd0b0c60b5..064360079e3566554bd92b627c68895a747801ed 100644 (file)
@@ -21,7 +21,7 @@ OpenGL: glClampColor(GL_CLAMP_VERTEX_COLOR) in GL 3.0 or GL_ARB_color_buffer_flo
 D3D11: seems always disabled
 
 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.
 
 
@@ -36,7 +36,7 @@ OpenGL: glClampColor(GL_CLAMP_FRAGMENT_COLOR) in GL 3.0 or ARB_color_buffer_floa
 D3D11: seems always disabled
 
 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.
 
 
@@ -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
 round sprites) and point_quad_rasterization MUST be true (sprites are
 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
 implemented natively by GPUs or implemented with a geometry shader.
index 8e96a6e48742f75871847c35d9f2645e64dedf49..6e97de70de57279ce6b658c5150211b149a3fd05 100644 (file)
@@ -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.
 
 
-State tracker-specific
-""""""""""""""""""""""
+GL State tracker-specific
+"""""""""""""""""""""""""
 
 .. envvar:: ST_DEBUG <flags> (0x0)
 
index 15468b6eebda122cd757f68e8e4494d7219ce99e..d745025d26dd3c9404f51b7e042c858398b1c9d2 100644 (file)
@@ -1,7 +1,7 @@
 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.
 
 Drivers
@@ -78,8 +78,8 @@ Rbug
 
 Wrapper driver. :ref:`rbug` driver used with stand alone rbug-gui.
 
-State Trackers
---------------
+Gallium frontends
+-----------------
 
 Clover
 ^^^^^^
@@ -101,9 +101,9 @@ GLX
 MesaGL
 ^^^^^^
 
-Tracker implementing a GL state machine. Not usable as a standalone tracker;
-Mesa should be built with another state tracker, such as :ref:`DRI` or
-:ref:`EGL`.
+The gallium frontend implementing a GL state machine. Not usable as
+a standalone frontend; Mesa should be built with another gallium frontend,
+such as :ref:`DRI` or :ref:`EGL`.
 
 VDPAU
 ^^^^^
index 6832b9993572c0913ed5c5a4382c8110e3f647e9..e1dfaccec68e1c990df9731f5bd9dc3e77b217fa 100644 (file)
@@ -85,7 +85,7 @@ The integer capabilities:
   per-instance vertex attribs.
 * ``PIPE_CAP_FRAGMENT_COLOR_CLAMPED``: Whether fragment color clamping is
   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.
 
 * ``PIPE_CAP_MIXED_COLORBUFFER_FORMATS``: Whether mixed colorbuffer formats are
@@ -99,7 +99,7 @@ The integer capabilities:
   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
   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
   shader.
 * ``PIPE_CAP_GLSL_FEATURE_LEVEL``: Whether the driver supports features
   equivalent to a specific GLSL version. E.g. for GLSL 1.3, report 130.
@@ -121,7 +121,7 @@ The integer capabilities:
 * ``PIPE_CAP_QUADS_FOLLOW_PROVOKING_VERTEX_CONVENTION``: Whether quads adhere to
   the flatshade_first setting in ``pipe_rasterizer_state``.
 * ``PIPE_CAP_USER_VERTEX_BUFFERS``: Whether the driver supports user vertex
-  buffers.  If not, the state tracker must upload all data which is not in hw
+  buffers.  If not, gallium frontends must upload all data which is not in hw
   resources.  If user-space buffers are supported, the driver must also still
   accept HW resource buffers.
 * ``PIPE_CAP_VERTEX_BUFFER_OFFSET_4BYTE_ALIGNED_ONLY``: This CAP describes a hw
@@ -164,7 +164,7 @@ The integer capabilities:
   input that will always be replaced with sprite coordinates.
 * ``PIPE_CAP_PREFER_BLIT_BASED_TEXTURE_TRANSFER``: Whether it is preferable
   to use a blit to implement a texture transfer which needs format conversions
-  and swizzling in state trackers. Generally, all hardware drivers with
+  and swizzling in gallium frontends. Generally, all hardware drivers with
   dedicated memory should return 1 and all software rasterizers should return 0.
 * ``PIPE_CAP_QUERY_PIPELINE_STATISTICS``: Whether PIPE_QUERY_PIPELINE_STATISTICS
   is supported.
@@ -256,7 +256,7 @@ The integer capabilities:
   for enabling ARB_clip_control.
 * ``PIPE_CAP_VERTEXID_NOBASE``: If true, the driver only supports
   TGSI_SEMANTIC_VERTEXID_NOBASE (and not TGSI_SEMANTIC_VERTEXID). This means
-  state trackers for APIs whose vertexIDs are offset by basevertex (such as GL)
+  gallium frontends for APIs whose vertexIDs are offset by basevertex (such as GL)
   will need to lower TGSI_SEMANTIC_VERTEXID to TGSI_SEMANTIC_VERTEXID_NOBASE
   and TGSI_SEMANTIC_BASEVERTEX, so drivers setting this must handle both these
   semantics. Only relevant if geometry shaders are supported.
@@ -310,11 +310,11 @@ The integer capabilities:
   supported in vertex shaders.
 * ``PIPE_CAP_TGSI_PACK_HALF_FLOAT``: Whether the ``UP2H`` and ``PK2H``
   TGSI opcodes are supported.
-* ``PIPE_CAP_TGSI_FS_POSITION_IS_SYSVAL``: If state trackers should use
+* ``PIPE_CAP_TGSI_FS_POSITION_IS_SYSVAL``: If gallium frontends should use
   a system value for the POSITION fragment shader input.
-* ``PIPE_CAP_TGSI_FS_POINT_IS_SYSVAL``: If state trackers should use
+* ``PIPE_CAP_TGSI_FS_POINT_IS_SYSVAL``: If gallium frontends should use
   a system value for the POINT fragment shader input.
-* ``PIPE_CAP_TGSI_FS_FACE_IS_INTEGER_SYSVAL``: If state trackers should use
+* ``PIPE_CAP_TGSI_FS_FACE_IS_INTEGER_SYSVAL``: If gallium frontends should use
   a system value for the FACE fragment shader input.
   Also, the FACE system value is integer, not float.
 * ``PIPE_CAP_SHADER_BUFFER_OFFSET_ALIGNMENT``: Describes the required
@@ -528,7 +528,7 @@ The integer capabilities:
   A driver might rely on the input mapping that was defined with the original
   GLSL code.
 * ``PIPE_CAP_IMAGE_LOAD_FORMATTED``: True if a format for image loads does not need to be specified in the shader IR
-* ``PIPE_CAP_THROTTLE``: Whether or not state trackers should throttle pipe_context
+* ``PIPE_CAP_THROTTLE``: Whether or not gallium frontends should throttle pipe_context
   execution. 0 = throttling is disabled.
 * ``PIPE_CAP_DMABUF``: Whether Linux DMABUF handles are supported by
   resource_from_handle and resource_get_handle.
@@ -537,7 +537,7 @@ The integer capabilities:
 * ``PIPE_CAP_FRAGMENT_SHADER_INTERLOCK``: True if fragment shader interlock
   functionality is supported.
 * ``PIPE_CAP_CS_DERIVED_SYSTEM_VALUES_SUPPORTED``: True if driver handles
-  gl_LocalInvocationIndex and gl_GlobalInvocationID.  Otherwise, state tracker will
+  gl_LocalInvocationIndex and gl_GlobalInvocationID.  Otherwise, gallium frontends will
   lower those system values.
 * ``PIPE_CAP_ATOMIC_FLOAT_MINMAX``: Atomic float point minimum,
   maximum, exchange and compare-and-swap support to buffer and shared variables.
@@ -552,7 +552,7 @@ The integer capabilities:
   types with texture functions having interaction with LOD of texture lookup.
 * ``PIPE_CAP_SHADER_SAMPLES_IDENTICAL``: True if the driver supports a shader query to tell whether all samples of a multisampled surface are definitely identical.
 * ``PIPE_CAP_TGSI_ATOMINC_WRAP``: Atomic increment/decrement + wrap around are supported.
-* ``PIPE_CAP_PREFER_IMM_ARRAYS_AS_CONSTBUF``: True if the state tracker should
+* ``PIPE_CAP_PREFER_IMM_ARRAYS_AS_CONSTBUF``: True if gallium frontends should
   turn arrays whose contents can be deduced at compile time into constant
   buffer loads, or false if the driver can handle such arrays itself in a more
   efficient manner.
@@ -667,7 +667,7 @@ MOV OUT[0], CONST[0][3]  # copy vector 3 of constbuf 0
   ignore tgsi_declaration_range::Last for shader inputs and outputs.
 * ``PIPE_SHADER_CAP_MAX_UNROLL_ITERATIONS_HINT``: This is the maximum number
   of iterations that loops are allowed to have to be unrolled. It is only
-  a hint to state trackers. Whether any loops will be unrolled is not
+  a hint to gallium frontends. Whether any loops will be unrolled is not
   guaranteed.
 * ``PIPE_SHADER_CAP_MAX_SHADER_BUFFERS``: Maximum number of memory buffers
   (also used to implement atomic counters). Having this be non-0 also
@@ -677,7 +677,7 @@ MOV OUT[0], CONST[0][3]  # copy vector 3 of constbuf 0
   program.  It should be a mask of ``pipe_shader_ir`` bits.
 * ``PIPE_SHADER_CAP_MAX_SHADER_IMAGES``: Maximum number of image units.
 * ``PIPE_SHADER_CAP_LOWER_IF_THRESHOLD``: IF and ELSE branches with a lower
-  cost than this value should be lowered by the state tracker for better
+  cost than this value should be lowered by gallium frontends for better
   performance. This is a tunable for the GLSL compiler and the behavior is
   specific to the compiler.
 * ``PIPE_SHADER_CAP_TGSI_SKIP_MERGE_REGISTERS``: Whether the merge registers
index fbf6869f885506c9f75f48ace7ef40749e06cc85..79d100769185c378fbefd6bf90f5fa820fcfe558 100644 (file)
@@ -2506,7 +2506,7 @@ after lookup.
   If per-sample shading is not in effect or the source resource or render
   target is not multisampled, the result is (0.5, 0.5, undef, undef).
 
-  NOTE: no driver has implemented this opcode yet (and no state tracker
+  NOTE: no driver has implemented this opcode yet (and no gallium frontend
   emits it).  This information is subject to change.
 
 .. opcode:: SAMPLE_INFO
@@ -2525,7 +2525,7 @@ after lookup.
   If per-sample shading is not in effect or the source resource or render
   target is not multisampled, the result is (1, 0, 0, 0).
 
-  NOTE: no driver has implemented this opcode yet (and no state tracker
+  NOTE: no driver has implemented this opcode yet (and no gallium frontend
   emits it).  This information is subject to change.
 
 .. opcode:: LOD - level of detail
index 67c68f9eb4d116e62e93687c4d38916e498dfd64..a9c341712819722c2765eb53b7a0e841fa14019f 100644 (file)
@@ -574,7 +574,7 @@ etna_context_create(struct pipe_screen *pscreen, void *priv, unsigned flags)
 
    /* context ctxate setup */
    ctx->screen = screen;
-   /* need some sane default in case state tracker doesn't set some state: */
+   /* need some sane default in case gallium frontends don't set some state: */
    ctx->sample_mask = 0xffff;
 
    /*  Set sensible defaults for state */
index 5559cc54f0b6f0e2020edfc8c7ad6eeb492207de..efafd1238c7d42b4fb400e54670ed125045cbacc 100644 (file)
@@ -90,7 +90,7 @@ etna_set_constant_buffer(struct pipe_context *pctx,
 
    util_copy_constant_buffer(&so->cb[index], cb);
 
-   /* Note that the state tracker can unbind constant buffers by
+   /* Note that the gallium frontends can unbind constant buffers by
     * passing NULL here. */
    if (unlikely(!cb || (!cb->buffer && !cb->user_buffer))) {
       so->enabled_mask &= ~(1 << index);
index 17a40a9fa6a261ed1cc6ee8ef3b15cefae502598..9a27a95e2c3833b742c622fa3d9ac5fc69095d6f 100644 (file)
@@ -380,7 +380,7 @@ fd_context_init(struct fd_context *ctx, struct pipe_screen *pscreen,
 
        (void) mtx_init(&ctx->gmem_lock, mtx_plain);
 
-       /* need some sane default in case state tracker doesn't
+       /* need some sane default in case gallium frontends don't
         * set some state:
         */
        ctx->sample_mask = 0xffff;
index 0586271fe6f0640983c1ba6f284579bbc8855ddf..cf81a0c3b90be565913aac8595bd548711522546 100644 (file)
@@ -380,7 +380,7 @@ fd_try_shadow_resource(struct fd_context *ctx, struct fd_resource *rsc,
  * Uncompress an UBWC compressed buffer "in place".  This works basically
  * like resource shadowing, creating a new resource, and doing an uncompress
  * blit, and swapping the state between shadow and original resource so it
- * appears to the state tracker as if nothing changed.
+ * appears to the gallium frontends as if nothing changed.
  */
 void
 fd_resource_uncompress(struct fd_context *ctx, struct fd_resource *rsc)
index a72958a1bc8a158a2dad80db348f88516e7247c4..2049e381cc0e0d67b7b4cc6d3a6d5d85c72f91a6 100644 (file)
@@ -104,7 +104,7 @@ fd_set_constant_buffer(struct pipe_context *pctx,
 
        util_copy_constant_buffer(&so->cb[index], cb);
 
-       /* Note that the state tracker can unbind constant buffers by
+       /* Note that gallium frontends can unbind constant buffers by
         * passing NULL here.
         */
        if (unlikely(!cb)) {
index e90f2dc757494e7ec91cf01aed88613fdd780ab7..d8a5edfebf40b23810358ce01c2d3326655dce47 100644 (file)
@@ -888,7 +888,7 @@ static void i915_set_clip_state( struct pipe_context *pipe,
 
 
 
-/* Called when driver state tracker notices changes to the viewport
+/* Called when gallium frontends notice changes to the viewport
  * matrix:
  */
 static void i915_set_viewport_states( struct pipe_context *pipe,
index 6533e11349d9e784fa5d263eea7828b7f8ef2b76..c23e281bdce6f5888f55d6a290bcb163cb6220ef 100644 (file)
@@ -731,7 +731,7 @@ _iris_batch_flush(struct iris_batch *batch, const char *file, int line)
     */
    if (ret == -EIO && replace_hw_ctx(batch)) {
       if (batch->reset->reset) {
-         /* Tell the state tracker the device is lost and it was our fault. */
+         /* Tell gallium frontends the device is lost and it was our fault. */
          batch->reset->reset(batch->reset->data, PIPE_GUILTY_CONTEXT_RESET);
       }
 
index dc497c161bd96b898bd315980a13cb063762a647..03d8c0bbc0e8384e2c34be1dfc492c91ee0c9a04 100644 (file)
@@ -189,7 +189,7 @@ iris_is_format_supported(struct pipe_screen *pscreen,
 
       /* Don't advertise 3-component RGB formats for non-buffer textures.
        * This ensures that they are renderable from an API perspective since
-       * the state tracker will fall back to RGBA or RGBX, which are
+       * gallium frontends will fall back to RGBA or RGBX, which are
        * renderable.  We want to render internally for copies and blits,
        * even if the application doesn't.
        *
index ee643c2ce8412c6e53474e1690b263a39fafac8f..284d9d69e7722a74ae77f9f5c5a69a926a1c9c6c 100644 (file)
@@ -1334,7 +1334,7 @@ iris_create_zsa_state(struct pipe_context *ctx,
       state->stencil[0].writemask != 0 ||
       (two_sided_stencil && state->stencil[1].writemask != 0);
 
-   /* The state tracker needs to optimize away EQUAL writes for us. */
+   /* gallium frontends need to optimize away EQUAL writes for us. */
    assert(!(state->depth.func == PIPE_FUNC_EQUAL && state->depth.writemask));
 
    iris_pack_command(GENX(3DSTATE_WM_DEPTH_STENCIL), cso->wmds, wmds) {
@@ -1987,7 +1987,7 @@ iris_upload_sampler_states(struct iris_context *ice, gl_shader_stage stage)
    struct iris_shader_state *shs = &ice->state.shaders[stage];
    const struct shader_info *info = iris_get_shader_info(ice, stage);
 
-   /* We assume the state tracker will call pipe->bind_sampler_states()
+   /* We assume gallium frontends will call pipe->bind_sampler_states()
     * if the program's number of textures changes.
     */
    unsigned count = info ? util_last_bit(info->textures_used) : 0;
@@ -2586,7 +2586,7 @@ iris_create_surface(struct pipe_context *ctx,
        * texture, the tile offsets may be anything and we can't rely on
        * X/Y Offset.
        *
-       * Return NULL to force the state tracker to take fallback paths.
+       * Return NULL to force gallium frontends to take fallback paths.
        */
       if (view->array_len > 1 || GEN_GEN == 8)
          return NULL;
index d7ec3591c6e3f2d033d997de65a80fb8c485857a..0d8bc4632632ae169967c831ba91a073a16e4c52 100644 (file)
@@ -440,7 +440,7 @@ lp_setup_try_clear_color_buffer(struct lp_setup_context *setup,
    else {
       /* Put ourselves into the 'pre-clear' state, specifically to try
        * and accumulate multiple clears to color and depth_stencil
-       * buffers which the app or state-tracker might issue
+       * buffers which the app or gallium frontend might issue
        * separately.
        */
       set_scene_state( setup, SETUP_CLEARED, __FUNCTION__ );
@@ -504,7 +504,7 @@ lp_setup_try_clear_zs(struct lp_setup_context *setup,
    else {
       /* Put ourselves into the 'pre-clear' state, specifically to try
        * and accumulate multiple clears to color and depth_stencil
-       * buffers which the app or state-tracker might issue
+       * buffers which the app or gallium frontend might issue
        * separately.
        */
       set_scene_state( setup, SETUP_CLEARED, __FUNCTION__ );
index 5d51736964ab98a60ad2bf14e2cedbbb49a6cba5..a0f6e2485d287a3a034833074563d21dcb5ea10a 100644 (file)
@@ -178,7 +178,7 @@ compute_vertex_info(struct llvmpipe_context *llvmpipe)
  * Called just prior to drawing anything (pipe::draw_arrays(), etc).
  *
  * Hopefully this will remain quite simple, otherwise need to pull in
- * something like the state tracker mechanism.
+ * something like the gallium frontend mechanism.
  */
 void llvmpipe_update_derived( struct llvmpipe_context *llvmpipe )
 {
index 6c5511e3e81d957312fa879c285861694b0ed3c4..5bebc10ea21d99f69738c9bf92fc3d5bf1d11ea6 100644 (file)
@@ -191,7 +191,7 @@ llvmpipe_create_sampler_view(struct pipe_context *pipe,
 #ifdef DEBUG
      /*
       * This is possibly too lenient, but the primary reason is just
-      * to catch state trackers which forget to initialize this, so
+      * to catch gallium frontends which forget to initialize this, so
       * it only catches clearly impossible view targets.
       */
       if (view->target != texture->target) {
index cbeaf3fd0baa5f5882708a98a56716e04cbac0f6..efcfbed80d579ea07be14c795c5d4babc69f9231 100644 (file)
@@ -545,7 +545,7 @@ llvmpipe_transfer_map_ms( struct pipe_context *pipe,
                                    do_not_block,
                                    __FUNCTION__)) {
          /*
-          * It would have blocked, but state tracker requested no to.
+          * It would have blocked, but gallium frontend requested no to.
           */
          assert(do_not_block);
          return NULL;
index 7abbf762af2fd91a0ec23ef596c8175f52fb526c..d1390aa32ad1d15c3620ebd55cb22fa6f24d3d90 100644 (file)
@@ -57,7 +57,7 @@ nvc0_screen_is_format_supported(struct pipe_screen *pscreen,
    if (MAX2(1, sample_count) != MAX2(1, storage_sample_count))
       return false;
 
-   /* Short-circuit the rest of the logic -- this is used by the state tracker
+   /* Short-circuit the rest of the logic -- this is used by the gallium frontend
     * to determine valid MS levels in a no-attachments scenario.
     */
    if (format == PIPE_FORMAT_NONE && bindings & PIPE_BIND_RENDER_TARGET)
index 5b02701392a14524672d4cb87540ebe52345b1d8..51c625554a52c5499f562ef8379bb67198f83eb4 100644 (file)
@@ -1313,7 +1313,7 @@ panfrost_batch_clear(struct panfrost_batch *batch,
 
         /* Clearing affects the entire framebuffer (by definition -- this is
          * the Gallium clear callback, which clears the whole framebuffer. If
-         * the scissor test were enabled from the GL side, the state tracker
+         * the scissor test were enabled from the GL side, the gallium frontend
          * would emit a quad instead and we wouldn't go down this code path) */
 
         panfrost_batch_union_scissor(batch, 0, 0,
index 1350e17485a4affb5983e8160187e17464a06cb6..131f396b21d93f2b0da71d40037c84217b1c30ee 100644 (file)
@@ -254,7 +254,7 @@ panfrost_mfbd_set_zsbuf(
 
         if (rsrc->layout == MALI_TEXTURE_AFBC) {
                 /* The only Z/S format we can compress is Z24S8 or variants
-                 * thereof (handled by the state tracker) */
+                 * thereof (handled by the gallium frontend) */
                 assert(panfrost_is_z24s8_variant(surf->format));
 
                 unsigned header_size = rsrc->slices[level].header_size;
index 2ccbe6d7acdd77692bfd542ef531074c60a811b4..9443f93e666b4eb79cbe5ec3d6261753a17316bb 100644 (file)
@@ -817,7 +817,7 @@ panfrost_generate_mipmap(
                                 PIPE_TEX_FILTER_LINEAR);
 
         /* If the blit was successful, flush once more. If it wasn't, well, let
-         * the state tracker deal with it. */
+         * the gallium frontend deal with it. */
 
         if (blit_res) {
                 panfrost_flush_batches_accessing_bo(ctx, rsrc->bo, PAN_BO_ACCESS_WRITE);
index ecfac6cddb029da2339f971828a69a3b3a2cd7e4..c422625409ed009bcbc80495de7778a73e713ac1 100644 (file)
@@ -506,7 +506,7 @@ panfrost_is_format_supported( struct pipe_screen *screen,
          * and then in the off-chance there's a CPU read we blit back to
          * staging.
          *
-         * ...alternatively, we can make the state tracker deal with that. */
+         * ...alternatively, we can make the gallium frontend deal with that. */
 
         if (bind & PIPE_BIND_DEPTH_STENCIL) {
                 switch (format) {
index 0a68d37b8066284a4bdc940b41754f861240f829..114f74ead24656cff1a3b82463d1a11b31916633 100644 (file)
@@ -262,7 +262,7 @@ static boolean r300_setup_atoms(struct r300_context* r300)
     return TRUE;
 }
 
-/* Not every state tracker calls every driver function before the first draw
+/* Not every gallium frontend calls every driver function before the first draw
  * call and we must initialize the command buffers somehow. */
 static void r300_init_states(struct pipe_context *pipe)
 {
index 667d3fd330637e1b72c5cf52461ea44e1c873a91..e63beee26b02ee66f8ff60f07cde080f8ad47a29 100644 (file)
@@ -280,7 +280,7 @@ struct r300_constant_buffer {
  * This is not a subclass of pipe_query because pipe_query is never
  * actually fully defined. So, rather than have it as a member, and do
  * subclass-style casting, we treat pipe_query as an opaque, and just
- * trust that our state tracker does not ever mess up query objects.
+ * trust that our gallium frontend does not ever mess up query objects.
  */
 struct r300_query {
     /* The kind of query. Currently only OQ is supported. */
index 9c21023481c8c48325b492cafcc84ba9392ee068..18e3e3b45796f1e780a72338a68e0e872e264ceb 100644 (file)
@@ -324,7 +324,7 @@ static boolean immd_is_good_idea(struct r300_context *r300,
     }
 
     /* Buffers can only be used for read by r300 (except query buffers, but
-     * those can't be bound by a state tracker as vertex buffers). */
+     * those can't be bound by an gallium frontend as vertex buffers). */
     return TRUE;
 }
 
index 931f7c697b63e24bb56232b718d1565a357dbd62..ac59ae5538908ed5ff9a160bf55963c3ce3b79d7 100644 (file)
@@ -356,9 +356,9 @@ static void r600_flush_from_st(struct pipe_context *ctx,
                        ws->cs_sync_flush(rctx->gfx.cs);
        } else {
                /* Instead of flushing, create a deferred fence. Constraints:
-                * - The state tracker must allow a deferred flush.
-                * - The state tracker must request a fence.
-                * Thread safety in fence_finish must be ensured by the state tracker.
+                * - the gallium frontend must allow a deferred flush.
+                * - the gallium frontend must request a fence.
+                * Thread safety in fence_finish must be ensured by the gallium frontend.
                 */
                if (flags & PIPE_FLUSH_DEFERRED && fence) {
                        gfx_fence = rctx->ws->cs_get_next_fence(rctx->gfx.cs);
index 5deb905c630b3843188f753a8798d882aad37de1..590d49467277a077f1230713415ee19d791bd48b 100644 (file)
@@ -1191,7 +1191,7 @@ static void r600_set_constant_buffer(struct pipe_context *ctx,
        struct pipe_constant_buffer *cb;
        const uint8_t *ptr;
 
-       /* Note that the state tracker can unbind constant buffers by
+       /* Note that the gallium frontend can unbind constant buffers by
         * passing NULL here.
         */
        if (unlikely(!input || (!input->buffer && !input->user_buffer))) {
@@ -1871,7 +1871,7 @@ static bool r600_update_derived_state(struct r600_context *rctx)
         * to LS slots and won't reflect what is dirty as VS stage even if the
         * TES didn't overwrite it. The story for re-enabled TES is similar.
         * In any case, we're not allowed to submit any TES state when
-        * TES is disabled (the state tracker may not do this but this looks
+        * TES is disabled (the gallium frontend may not do this but this looks
         * like an optimization to me, not something which can be relied on).
         */
 
index 91d1bed505d285bac39704871d59508788f58a8c..f6505ecf26ce0c7d4efd30b9c5e1f552be560537 100644 (file)
@@ -490,10 +490,10 @@ static void si_flush_from_st(struct pipe_context *ctx, struct pipe_fence_handle
          ws->cs_sync_flush(sctx->gfx_cs);
    } else {
       /* Instead of flushing, create a deferred fence. Constraints:
-       * - The state tracker must allow a deferred flush.
-       * - The state tracker must request a fence.
+                * - the gallium frontend must allow a deferred flush.
+                * - the gallium frontend must request a fence.
        * - fence_get_fd is not allowed.
-       * Thread safety in fence_finish must be ensured by the state tracker.
+                * Thread safety in fence_finish must be ensured by the gallium frontend.
        */
       if (flags & PIPE_FLUSH_DEFERRED && !(flags & PIPE_FLUSH_FENCE_FD) && fence) {
          gfx_fence = sctx->ws->cs_get_next_fence(sctx->gfx_cs);
index 087df67d61d97f9aed49e588f651fc04ea3eeec7..d6baf1ec9d443315a6b4ceb6305205241748ac8a 100644 (file)
@@ -112,7 +112,7 @@ void si_flush_gfx_cs(struct si_context *ctx, unsigned flags, struct pipe_fence_h
 
    ctx->gfx_flush_in_progress = true;
 
-   /* If the state tracker is flushing the GFX IB, si_flush_from_st is
+       /* If the gallium frontend is flushing the GFX IB, si_flush_from_st is
     * responsible for flushing the DMA IB and merging the fences from both.
     * If the driver flushes the GFX IB internally, and it should never ask
     * for a fence handle.
index f3457924e77557bcb00fd6b80a48f673ab8f294f..832799de0d0a43d76167d7b4084cd261345937ad 100644 (file)
@@ -322,7 +322,7 @@ static enum pipe_reset_status si_get_reset_status(struct pipe_context *ctx)
    enum pipe_reset_status status = sctx->ws->ctx_query_reset_status(sctx->ctx);
 
    if (status != PIPE_NO_RESET) {
-      /* Call the state tracker to set a no-op API dispatch. */
+               /* Call the gallium frontend to set a no-op API dispatch. */
       if (sctx->device_reset_callback.reset) {
          sctx->device_reset_callback.reset(sctx->device_reset_callback.data, status);
       }
index ddbb5c5c9c705fad609e3614ddf1af219b36410a..07be19f4206a1d8c8f6bd4a5b68447ecb3e3dd1d 100644 (file)
@@ -870,7 +870,7 @@ static void si_nir_lower_ps_inputs(struct nir_shader *nir)
 
 void si_nir_adjust_driver_locations(struct nir_shader *nir)
 {
-   /* Adjust the driver location of inputs and outputs. The state tracker
+       /* Adjust the driver location of inputs and outputs. the gallium frontend
     * interprets them as slots, while the ac/nir backend interprets them
     * as individual components.
     */
index b20a59de1a1b9f7e62b6cdad0ddf6468ab515de0..b9fea68ba0275316e959c5b09fcc65e9fa83ce8a 100644 (file)
@@ -4284,7 +4284,7 @@ struct pipe_sampler_view *si_create_sampler_view_custom(struct pipe_context *ctx
       depth = u_minify(depth, force_level);
    }
 
-   /* This is not needed if state trackers set last_layer correctly. */
+   /* This is not needed if gallium frontends set last_layer correctly. */
    if (state->target == PIPE_TEXTURE_1D || state->target == PIPE_TEXTURE_2D ||
        state->target == PIPE_TEXTURE_RECT || state->target == PIPE_TEXTURE_CUBE)
       last_layer = state->u.tex.first_layer;
@@ -4554,7 +4554,7 @@ static void si_emit_sample_mask(struct si_context *sctx)
    unsigned mask = sctx->sample_mask;
 
    /* Needed for line and polygon smoothing as well as for the Polaris
-    * small primitive filter. We expect the state tracker to take care of
+        * small primitive filter. We expect the gallium frontend to take care of
     * this for us.
     */
    assert(mask == 0xffff || sctx->framebuffer.nr_samples > 1 ||
index edb5944aec3c7093f2497e2f83f4331fa21a8ce4..328587c956556524bbfec9f769b3209d88e3da3b 100644 (file)
@@ -1283,7 +1283,7 @@ struct pipe_resource *si_texture_create(struct pipe_screen *screen,
 
    if (templ->nr_samples >= 2) {
       /* This is hackish (overwriting the const pipe_resource template),
-       * but should be harmless and state trackers can also see
+                * but should be harmless and gallium frontends can also see
        * the overriden number of samples in the created pipe_resource.
        */
       if (is_zs && sscreen->eqaa_force_z_samples) {
index bfa547df1872bce1bb0b8a2f4ccf241f11a25b86..21b867ad1b7a9783327aefbfa2a80ea9325fbc98 100644 (file)
@@ -132,7 +132,7 @@ struct softpipe_context {
    /** Which vertex shader output slot contains layer */
    int8_t layer_slot;
 
-   /** The reduced version of the primitive supplied by the state tracker */
+   /** The reduced version of the primitive supplied by the gallium frontend */
    unsigned reduced_api_prim;
 
    /** Derived information about which winding orders to cull */
index f9d43bd6ea8260446b354fe1b884ae4e0c84bde0..b2ce4cee4aae62ee7d4fb8f87c99e4a7f7886b18 100644 (file)
@@ -451,7 +451,7 @@ softpipe_is_format_supported( struct pipe_screen *screen,
       /*
        * Although possible, it is unnatural to render into compressed or YUV
        * surfaces. So disable these here to avoid going into weird paths
-       * inside the state trackers.
+       * inside gallium frontends.
        */
       if (format_desc->block.width != 1 ||
           format_desc->block.height != 1)
index f34997ab3d0b6114c339dffed7eaf3741a8e61ac..b4f87e02666c9b0d3371000992555041d58b2d5d 100644 (file)
@@ -428,7 +428,7 @@ update_polygon_stipple_enable(struct softpipe_context *softpipe, unsigned prim)
 
 
 /* Hopefully this will remain quite simple, otherwise need to pull in
- * something like the state tracker mechanism.
+ * something like the gallium frontend mechanism.
  */
 void
 softpipe_update_derived(struct softpipe_context *softpipe, unsigned prim)
index 5a0ec40d9c8632e2ecc8f25e6a6075b902d2a9fa..ab7f73e92bd51280f8bf1928772465fb80b957c4 100644 (file)
@@ -3599,7 +3599,7 @@ softpipe_create_sampler_view(struct pipe_context *pipe,
 #ifdef DEBUG
      /*
       * This is possibly too lenient, but the primary reason is just
-      * to catch state trackers which forget to initialize this, so
+      * to catch gallium frontends which forget to initialize this, so
       * it only catches clearly impossible view targets.
       */
       if (view->target != resource->target) {
index 60afb2b6740dd7608eece68765c156a81617b945..eef8b88f594336b9775594e5eedb913d52e18da7 100644 (file)
@@ -452,7 +452,7 @@ struct svga_context
       boolean no_line_width;
       boolean force_hw_line_stipple;
 
-      /** To report perf/conformance/etc issues to the state tracker */
+      /** To report perf/conformance/etc issues to the gallium frontend */
       struct pipe_debug_callback callback;
    } debug;
 
@@ -507,7 +507,7 @@ struct svga_context
       struct svga_hw_clear_state    hw_clear;
    } state;
 
-   struct svga_state curr;      /* state from the state tracker */
+   struct svga_state curr;      /* state from the gallium frontend */
    unsigned dirty;              /* statechanges since last update_state() */
 
    union {
index d889d4a13a8a1b7819c856265cde12eaf9d43e04..31806ceb1e1e034ca34d86dfb549f017b32d0e0f 100644 (file)
@@ -382,7 +382,7 @@ can_blit_via_intra_surface_copy(struct svga_context *svga,
 
 
 /**
- * The state tracker implements some resource copies with blits (for
+ * the gallium frontend implements some resource copies with blits (for
  * GL_ARB_copy_image).  This function checks if we should really do the blit
  * with a VGPU10 CopyRegion command or software fallback (for incompatible
  * src/dst formats).
index 04707f61d2a6b39447b615f646455f5f36b98ef8..e0d1e51f412c8e5cd978c0e039eec5803cd002ce 100644 (file)
@@ -208,7 +208,7 @@ svga_set_viewport_states(struct pipe_context *pipe,
 
 /**
  * Called by state tracker to specify a callback function the driver
- * can use to report info back to the state tracker.
+ * can use to report info back to the gallium frontend.
  */
 static void
 svga_set_debug_callback(struct pipe_context *pipe,
index 1362ffed2b882b236e44a5e93f0493491838c6e9..6629a8cc14d96083cdb2d9a0b1a8b7d3f797a758 100644 (file)
@@ -62,7 +62,7 @@ svga_buffer_needs_hw_storage(const struct svga_screen *ss,
        */
       bind_mask |= PIPE_BIND_CUSTOM;
       /* Uniform buffer objects.
-       * Make sure we don't create hardware storage for state-tracker
+       * Make sure we don't create hardware storage for gallium frontend
        * const0 buffers, because we frequently map them for reading.
        * They are distinguished by having PIPE_USAGE_STREAM, but not
        * PIPE_BIND_CUSTOM.
@@ -217,7 +217,7 @@ svga_buffer_transfer_map(struct pipe_context *pipe,
                /*
                 * We have a pending DMA upload from a hardware buffer, therefore
                 * we need to ensure that the host finishes processing that DMA
-                * command before the state tracker can start overwriting the
+                * command before the gallium frontend can start overwriting the
                 * hardware buffer.
                 *
                 * XXX: This could be avoided by tying the hardware buffer to
@@ -464,7 +464,7 @@ svga_buffer_create(struct pipe_screen *screen,
       /* If the buffer is not used for constant buffer, set
        * the vertex/index bind flags as well so that the buffer will be
        * accepted for those uses.
-       * Note that the PIPE_BIND_ flags we get from the state tracker are
+       * Note that the PIPE_BIND_ flags we get from the gallium frontend are
        * just a hint about how the buffer may be used.  And OpenGL buffer
        * object may be used for many different things.
        * Also note that we do not unconditionally set the streamout
index 2385da2e99950dcfd750cb3d25ce5fde0c42bb0b..2aa4e52faa75ae3f4a6b7d74379b3fa21bc3ff4e 100644 (file)
@@ -937,7 +937,7 @@ svga_texture_create(struct pipe_screen *screen,
 
    /* Verify the number of mipmap levels isn't impossibly large.  For example,
     * if the base 2D image is 16x16, we can't have 8 mipmap levels.
-    * The state tracker should never ask us to create a resource with invalid
+    * the gallium frontend should never ask us to create a resource with invalid
     * parameters.
     */
    {
@@ -1119,7 +1119,7 @@ svga_texture_create(struct pipe_screen *screen,
     * and it always requests PIPE_BIND_RENDER_TARGET, therefore
     * passing the SVGA3D_SURFACE_HINT_RENDERTARGET here defeats its purpose.
     *
-    * However, this was changed since other state trackers
+    * However, this was changed since other gallium frontends
     * (XA for example) uses it accurately and certain device versions
     * relies on it in certain situations to render correctly.
     */
index dc521cf3f9cddf835d8060a94c89736e3cfc8b38..c8db3947e08821eab9b4e750241fbcba496d2c75 100644 (file)
@@ -534,8 +534,8 @@ vgpu9_get_shader_param(struct pipe_screen *screen,
          /*
           * Although PS 3.0 has some addressing abilities it can only represent
           * loops that can be statically determined and unrolled. Given we can
-          * only handle a subset of the cases that the state tracker already
-          * does it is better to defer loop unrolling to the state tracker.
+          * only handle a subset of the cases that the gallium frontend already
+          * does it is better to defer loop unrolling to the gallium frontend.
           */
          return 0;
       case PIPE_SHADER_CAP_TGSI_CONT_SUPPORTED:
index 20096c036c91fa5bc4c7a3a1e2473d732a006f82..e489acd078b859cea231d2244504ee7ab9c5e3a6 100644 (file)
@@ -449,7 +449,7 @@ struct svga_winsys_context
                       struct svga_winsys_gb_shader *shader,
                       unsigned flags);
 
-   /** To report perf/conformance/etc issues to the state tracker */
+   /** To report perf/conformance/etc issues to the gallium frontend */
    struct pipe_debug_callback *debug_callback;
 
    /** The more recent command issued to command buffer */
index 2939637f1c55e6b374df35c380c5293137291ae9..9e8ee45bfb56714de5c32996297d18c1d8ae39c6 100644 (file)
@@ -127,7 +127,7 @@ swr_is_format_supported(struct pipe_screen *_screen,
       /*
        * Although possible, it is unnatural to render into compressed or YUV
        * surfaces. So disable these here to avoid going into weird paths
-       * inside the state trackers.
+       * inside gallium frontends.
        */
       if (format_desc->block.width != 1 || format_desc->block.height != 1)
          return false;
index 8e58468006c46bfa778930e11ddbd9d136e5665f..ee41b9fa75e9dba5c15e02432e46d29c69728a50 100644 (file)
@@ -453,7 +453,7 @@ v3d_set_constant_buffer(struct pipe_context *pctx, uint shader, uint index,
 
         util_copy_constant_buffer(&so->cb[index], cb);
 
-        /* Note that the state tracker can unbind constant buffers by
+        /* Note that the gallium frontend can unbind constant buffers by
          * passing NULL here.
          */
         if (unlikely(!cb)) {
index 1e4657a79227394084dcc8a13eefb1e75f517cc6..77431e4557ccf40feadad04b513c666c732b57b5 100644 (file)
@@ -387,7 +387,7 @@ vc4_set_constant_buffer(struct pipe_context *pctx,
         struct vc4_context *vc4 = vc4_context(pctx);
         struct vc4_constbuf_stateobj *so = &vc4->constbuf[shader];
 
-        /* Note that the state tracker can unbind constant buffers by
+        /* Note that the gallium frontend can unbind constant buffers by
          * passing NULL here.
          */
         if (unlikely(!cb)) {
index 6ce08b764ece0b6791074359ac5e7542a754b7cd..4cbca21ac96b8dd92d304f0ae088441a59f3a228 100644 (file)
@@ -725,7 +725,7 @@ virgl_is_format_supported( struct pipe_screen *screen,
       /*
        * Although possible, it is unnatural to render into compressed or YUV
        * surfaces. So disable these here to avoid going into weird paths
-       * inside the state trackers.
+       * inside gallium frontends.
        */
       if (format_desc->block.width != 1 ||
           format_desc->block.height != 1)
index 8fc2175d236f2828ba2516e69fa7a53f7999f9aa..4f233425145dc783de2982b29954f18859fa829a 100644 (file)
@@ -35,7 +35,7 @@
 #include "util/macros.h"
 
 ///
-/// Main namespace of the CL state tracker.
+/// Main namespace of the CL gallium frontend.
 ///
 namespace clover {
    ///
index 334934b85c7d7c725894d60ed221a376fb3d304b..bfbaa1bd84aa6b4d4d101494bc8dccb7ffef94af 100644 (file)
@@ -594,10 +594,10 @@ dri2_allocate_textures(struct dri_context *ctx,
                 * such that they contain the same data as the single-sample
                 * resources we just got from the X server.
                 *
-                * The reason for this is that the state tracker (and
+                * The reason for this is that the gallium frontend (and
                 * therefore the app) can access the MSAA resources only.
                 * The single-sample resources are not exposed
-                * to the state tracker.
+                * to the gallium frontend.
                 *
                 */
                dri_pipe_blit(ctx->st->pipe,
@@ -748,7 +748,7 @@ dri2_create_image_from_winsys(__DRIscreen *_screen,
       tex_usage |= PIPE_BIND_SAMPLER_VIEW;
 
    if (!tex_usage && util_format_is_yuv(map->pipe_format)) {
-      /* YUV format sampling can be emulated by the Mesa state tracker by
+      /* YUV format sampling can be emulated by the GL gallium frontend by
        * using multiple samplers of varying formats.
        * If no tex_usage is set and we detect a YUV format,
        * test for support of all planes' sampler formats and
index 2ee4f185537406649d0b473986cd7f30b4c0cc3c..5ef0a2ca077d1a80bd302bfedc725e5b8eb758bd 100644 (file)
@@ -107,7 +107,7 @@ dri_st_framebuffer_validate(struct st_context_iface *stctx,
    if (!out)
       return true;
 
-   /* Set the window-system buffers for the state tracker. */
+   /* Set the window-system buffers for the gallium frontend. */
    for (i = 0; i < count; i++)
       pipe_resource_reference(&out[i], textures[statts[i]]);
 
@@ -130,7 +130,7 @@ dri_st_framebuffer_flush_front(struct st_context_iface *stctx,
 }
 
 /**
- * The state tracker framebuffer interface flush_swapbuffers callback
+ * The gallium frontend framebuffer interface flush_swapbuffers callback
  */
 static bool
 dri_st_framebuffer_flush_swapbuffers(struct st_context_iface *stctx,
@@ -552,8 +552,8 @@ dri_flush(__DRIcontext *cPriv,
          drawable->msaa_textures[ST_ATTACHMENT_BACK_LEFT];
       drawable->msaa_textures[ST_ATTACHMENT_BACK_LEFT] = tmp;
 
-      /* Now that we have swapped the buffers, this tells the state
-       * tracker to revalidate the framebuffer.
+      /* Now that we have swapped the buffers, this tells the gallium
+       * frontend to revalidate the framebuffer.
        */
       p_atomic_inc(&drawable->base.stamp);
    }
index fee392bba3128526870cf9fdc31cab95bb70d8cf..a6ba68eaec323b6a74eb7bdf774461482572ab6e 100644 (file)
@@ -451,7 +451,7 @@ dri_fill_st_visual(struct st_visual *stvis,
 
    if (mode->depthBits > 0 || mode->stencilBits > 0)
       stvis->buffer_mask |= ST_ATTACHMENT_DEPTH_STENCIL_MASK;
-   /* let the state tracker allocate the accum buffer */
+   /* let the gallium frontend allocate the accum buffer */
 }
 
 static bool
index 9afc5f5d7cfd0ae1f94ad18d9a757552793f9b2a..05fa7848e10a96af917cf860c754b438402e0f16 100644 (file)
@@ -34,7 +34,7 @@
 struct pipe_screen;
 struct st_api;
 
-/* This is the driver interface required by the glx/xlib state tracker. 
+/* This is the driver interface required by the glx/xlib frontends.
  */
 struct xm_driver {
    struct pipe_screen *(*create_pipe_screen)( Display *display );
index 26a61f069a4a6541a78fbb042ae533baec84ac42..4cb452657aebc6d8c7bb6f8c2b0125fe8cd36496 100644 (file)
@@ -55,13 +55,13 @@ struct hgl_buffer
 struct hgl_context
 {
        struct st_api* api;
-               // State Tracker API
+               // API
        struct st_manager* manager;
-               // State Tracker Manager
+               // Manager
        struct st_context_iface* st;
-               // State Tracker Interface Object
+               // Interface Object
        struct st_visual* stVisual;
-               // State Tracker Visual
+               // Visual
 
        struct pipe_screen* screen;
 
index e3426b481cd84455affba4debe93cb57dd8544fa..9faf83f34180923b700ea65b4342a7986eec883d 100644 (file)
@@ -453,7 +453,7 @@ NineSwapChain9_Resize( struct NineSwapChain9 *This,
     return D3D_OK;
 }
 
-/* Throttling: code adapted from the dri state tracker */
+/* Throttling: code adapted from the dri frontend */
 
 /**
  * swap_fences_pop_front - pull a fence from the throttle queue
index 8689c1113a3f6010fdae5bb68a523c830fa15abb..23537c3602e2e2da2ff18bf62a171c5f94183a72 100644 (file)
@@ -23,7 +23,7 @@
 
 /*
  * Off-Screen rendering into client memory.
- * State tracker for gallium (for softpipe and llvmpipe)
+ * OpenGL gallium frontend for softpipe and llvmpipe.
  *
  * Notes:
  *
index bce4400b0eee67e4de988cd8412339841db7ae4e..799c2cb1f1b21a2ca2d9d3dff73bac3de1bf6e89 100644 (file)
@@ -461,7 +461,7 @@ vlVdpVideoSurfaceClear(vlVdpSurface *vlsurf)
 }
 
 /**
- * Interop to mesa state tracker
+ * Interop for the GL gallium frontend
  */
 struct pipe_video_buffer *vlVdpVideoSurfaceGallium(VdpVideoSurface surface)
 {
index 1f46f31a549c9d29ea7c68163fd1587b408e95e5..f69458445c26a5ebd1505435fce3f66b13475f12 100644 (file)
@@ -546,7 +546,7 @@ VdpGenerateCSCMatrix vlVdpGenerateCSCMatrix;
 VdpPresentationQueueTargetCreateX11 vlVdpPresentationQueueTargetCreateX11;
 
 
-/* interop to mesa state tracker */
+/* interop for GL gallium frontend */
 VdpVideoSurfaceGallium vlVdpVideoSurfaceGallium;
 VdpOutputSurfaceGallium vlVdpOutputSurfaceGallium;
 VdpVideoSurfaceDMABuf vlVdpVideoSurfaceDMABuf;
index 8696300f3e08805ce8ff23398e91e0b6498284da..c4f8ff194ea1faba96b48c99721d92896d20b5f7 100644 (file)
@@ -190,7 +190,7 @@ stw_pixelformat_add(struct stw_device *stw_dev,
    pfi->pfd.dwDamageMask = 0;
 
    /*
-    * since state trackers can allocate depth/stencil/accum buffers, we provide
+    * since gallium frontend can allocate depth/stencil/accum buffers, we provide
     * only color buffers here
     */
    pfi->stvis.buffer_mask = ST_ATTACHMENT_FRONT_LEFT_MASK;
index e173c816c7c7ca35f4ef570f61de35be1226f7b2..44bc60c45eb5009069abd4cbd47e6b88e3b35c5a 100644 (file)
@@ -385,7 +385,7 @@ stw_get_framebuffer_resource(struct st_framebuffer_iface *stfb,
 
 
 /**
- * Create an st_api of the state tracker.
+ * Create an st_api of the gallium frontend.
  */
 struct st_api *
 stw_st_create_api(void)
index 9103c750ea9b3b1da50b2788a00b8553a9291194..bbb3beaf9e5ed4739907d3ec00808e163ac5e931 100644 (file)
@@ -28,7 +28,7 @@
 /**
  * @file
  *
- * Fake WGL API implementation.
+ * Fake WGL gallium frontend.
  *
  * These functions implement the WGL API, on top of the ICD DDI, so that the
  * resulting DLL can be used as a drop-in replacement for the system's
index 5bcb8d9fea620232dd16f4e4de987b19f039ac00..a7e602c874fb34f9f74e5ce8ac61d29bd0c43e32 100644 (file)
 #include "pipe/p_format.h"
 
 /**
- * \file API for communication between state trackers and state tracker
- * managers.
+ * \file API for communication between gallium frontends and supporting
+ * frontends such as DRI.
  *
- * While both are state tackers, we use the term state tracker for rendering
- * APIs such as OpenGL or OpenVG, and state tracker manager for window system
- * APIs such as EGL or GLX in this file.
- *
- * This file defines an API to be implemented by both state trackers and state
- * tracker managers.
+ * This file defines an API to be implemented by both gallium frontends and
+ * their managers.
  */
 
 /**
- * The supported rendering API of a state tracker.
+ * The supported rendering API.
  */
 enum st_api_type {
    ST_API_OPENGL,
@@ -69,7 +65,7 @@ enum st_profile_type
 #define ST_PROFILE_OPENGL_ES2_MASK   (1 << ST_PROFILE_OPENGL_ES2)
 
 /**
- * Optional API/state tracker features.
+ * Optional API features.
  */
 enum st_api_feature
 {
@@ -155,10 +151,10 @@ enum st_attachment_type {
  */
 enum st_manager_param {
    /**
-    * The dri state tracker on old libGL's doesn't do the right thing
+    * The DRI frontend on old libGL's doesn't do the right thing
     * with regards to invalidating the framebuffers.
     *
-    * For the mesa state tracker that means that it needs to invalidate
+    * For the GL gallium frontend that means that it needs to invalidate
     * the framebuffer in glViewport itself.
     */
    ST_MANAGER_BROKEN_INVALIDATE
@@ -274,11 +270,11 @@ struct st_manager;
 /**
  * Represent a windowing system drawable.
  *
- * The framebuffer is implemented by the state tracker manager and
- * used by the state trackers.
+ * The framebuffer is implemented by the frontend manager and
+ * used by gallium frontends.
  *
- * Instead of the winsys poking into the API context to figure
- * out what buffers that might be needed in the future by the API
+ * Instead of the winsys poking into the frontend context to figure
+ * out what buffers that might be needed in the future by the frontend
  * context, it calls into the framebuffer to get the textures.
  *
  * This structure along with the notify_invalid_framebuffer
@@ -303,12 +299,12 @@ struct st_framebuffer_iface
    uint32_t ID;
 
    /**
-    * The state tracker manager that manages this object.
+    * The frontend manager that manages this object.
     */
    struct st_manager *state_manager;
 
    /**
-    * Available for the state tracker manager to use.
+    * Available for the frontend manager to use.
     */
    void *st_manager_private;
 
@@ -330,7 +326,7 @@ struct st_framebuffer_iface
                        enum st_attachment_type statt);
 
    /**
-    * The state tracker asks for the textures it needs.
+    * the gallium frontend asks for the textures it needs.
     *
     * It should try to only ask for attachments that it currently renders
     * to, thus allowing the winsys to delay the allocation of textures not
@@ -358,18 +354,18 @@ struct st_framebuffer_iface
 /**
  * Represent a rendering context.
  *
- * This entity is created from st_api and used by the state tracker manager.
+ * This entity is created from st_api and used by the frontend manager.
  */
 struct st_context_iface
 {
    /**
-    * Available for the state tracker and the manager to use.
+    * Available for the gallium frontend and the manager to use.
     */
    void *st_context_private;
    void *st_manager_private;
 
    /**
-    * The state tracker manager that manages this object.
+    * The frontend manager that manages this object.
     */
    struct st_manager *state_manager;
 
@@ -435,9 +431,9 @@ struct st_context_iface
 
 
 /**
- * Represent a state tracker manager.
+ * Represent a frontend manager.
  *
- * This interface is implemented by the state tracker manager.  It corresponds
+ * This interface is implemented by the frontend manager.  It corresponds
  * to a "display" in the window system.
  */
 struct st_manager
@@ -477,12 +473,12 @@ struct st_manager
                                   struct util_queue_monitoring *queue_info);
 
    /**
-    * Destroy any private data used by the state tracker manager.
+    * Destroy any private data used by the frontend manager.
     */
    void (*destroy)(struct st_manager *smapi);
 
    /**
-    * Available for the state tracker manager to use.
+    * Available for the frontend manager to use.
     */
    void *st_manager_private;
 };
@@ -490,7 +486,7 @@ struct st_manager
 /**
  * Represent a rendering API such as OpenGL or OpenVG.
  *
- * Implemented by the state tracker and used by the state tracker manager.
+ * Implemented by the gallium frontend and used by the frontend manager.
  */
 struct st_api
 {
index 49ffa5df13f66c367c650e5c13b8d9dee50f7605..ad5119ba8e4da1e9f888fa74cdcdb33abcb081ca 100644 (file)
@@ -8,7 +8,7 @@
 /* This is what the xlib software winsys expects to find in the
  * "private" field of flush_frontbuffers().
  *
- * Xlib-based state trackers somehow need to know this.
+ * Xlib-based gallium frontends somehow need to know this.
  */
 struct xlib_drawable {
    Visual *visual;
index 37957466ded4d22ef91a79b7c930c2b9b83157ac..1869d22ad47607f61578eb3dfbbc50aab40273ee 100644 (file)
@@ -91,7 +91,7 @@ struct pipe_context {
    void *draw;  /**< private, for draw module (temporary?) */
 
    /**
-    * Stream uploaders created by the driver. All drivers, state trackers, and
+    * Stream uploaders created by the driver. All drivers, gallium frontends, and
     * modules should use them.
     *
     * Use u_upload_alloc or u_upload_data as many times as you want.
index 723e328a32b3e31dd74b2a31f25f761d08511fb5..c805d3a78a7f8380bd7ce873c3edd0b1dca53ead 100644 (file)
@@ -255,10 +255,10 @@ enum pipe_transfer_usage
 
    /** 
     * The transfer should map the texture storage directly. The driver may
-    * return NULL if that isn't possible, and the state tracker needs to cope
+    * return NULL if that isn't possible, and the gallium frontend needs to cope
     * with that and use an alternative path without this flag.
     *
-    * E.g. the state tracker could have a simpler path which maps textures and
+    * E.g. the gallium frontend could have a simpler path which maps textures and
     * does read/modify/write cycles on them directly, and a more complicated
     * path which uses minimal read and write transfers.
     *
@@ -448,7 +448,7 @@ enum pipe_flush_flags
 #define PIPE_TEXTURE_BARRIER_FRAMEBUFFER  (1 << 1)
 
 /**
- * Resource binding flags -- state tracker must specify in advance all
+ * Resource binding flags -- gallium frontends must specify in advance all
  * the ways a resource might be used.
  */
 #define PIPE_BIND_DEPTH_STENCIL        (1 << 0) /* create_surface */
@@ -462,7 +462,7 @@ enum pipe_flush_flags
 /* gap */
 #define PIPE_BIND_STREAM_OUTPUT        (1 << 10) /* set_stream_output_buffers */
 #define PIPE_BIND_CURSOR               (1 << 11) /* mouse cursor */
-#define PIPE_BIND_CUSTOM               (1 << 12) /* state-tracker/winsys usages */
+#define PIPE_BIND_CUSTOM               (1 << 12) /* gallium frontend/winsys usages */
 #define PIPE_BIND_GLOBAL               (1 << 13) /* set_global_binding */
 #define PIPE_BIND_SHADER_BUFFER        (1 << 14) /* set_shader_buffers */
 #define PIPE_BIND_SHADER_IMAGE         (1 << 15) /* set_shader_images */
@@ -477,10 +477,9 @@ enum pipe_flush_flags
  * below do not fit within that and probably need to be migrated to some
  * other place.
  *
- * It seems like scanout is used by the Xorg state tracker to ask for
- * a texture suitable for actual scanout (hence the name), which
- * implies extra layout constraints on some hardware.  It may also
- * have some special meaning regarding mouse cursor images.
+ * Scanout is used to ask for a texture suitable for actual scanout (hence
+ * the name), which implies extra layout constraints on some hardware.
+ * It may also have some special meaning regarding mouse cursor images.
  *
  * The shared flag is quite underspecified, but certainly isn't a
  * binding flag - it seems more like a message to the winsys to create
@@ -504,7 +503,7 @@ enum pipe_flush_flags
 #define PIPE_RESOURCE_FLAG_SINGLE_THREAD_USE     (1 << 4)
 #define PIPE_RESOURCE_FLAG_ENCRYPTED             (1 << 5)
 #define PIPE_RESOURCE_FLAG_DRV_PRIV    (1 << 8) /* driver/winsys private */
-#define PIPE_RESOURCE_FLAG_ST_PRIV     (1 << 24) /* state-tracker/winsys private */
+#define PIPE_RESOURCE_FLAG_ST_PRIV     (1 << 24) /* gallium frontend/winsys private */
 
 /**
  * Hint about the expected lifecycle of a resource.
@@ -1044,7 +1043,7 @@ enum pipe_shader_cap
  * get TGSI.
  *
  * Note that PIPE_SHADER_IR_TGSI should be zero for backwards compat with
- * state trackers that only understand TGSI.
+ * gallium frontends that only understand TGSI.
  */
 enum pipe_shader_ir
 {
index 0f2831b6eda72b36ccb9f80e3811243568470dda..a4b07c8ee251bc7985957f541a4ec238af00a1c7 100644 (file)
@@ -223,7 +223,7 @@ struct pipe_screen {
                                                        void *user_memory);
 
    /**
-    * Unlike pipe_resource::bind, which describes what state trackers want,
+    * Unlike pipe_resource::bind, which describes what gallium frontends want,
     * resources can have much greater capabilities in practice, often implied
     * by the tiling layout or memory placement. This function allows querying
     * whether a capability is supported beyond what was requested by state
@@ -504,7 +504,7 @@ struct pipe_screen {
    /**
     * Run driver-specific NIR lowering and optimization passes.
     *
-    * State trackers should call this before passing shaders to drivers,
+    * gallium frontends should call this before passing shaders to drivers,
     * and ideally also before shader caching.
     *
     * \param optimize  Whether the input shader hasn't been optimized and
index 2a14b9a43591dc8564f88a2b665777a340f93b68..b75906d148fe816721c31710079830121c2c844c 100644 (file)
@@ -276,7 +276,7 @@ struct pipe_stream_output_info
  *
  * NOTE: since it is expected that the consumer will want to perform
  * additional passes on the nir_shader, the driver takes ownership of
- * the nir_shader.  If state trackers need to hang on to the IR (for
+ * the nir_shader.  If gallium frontends need to hang on to the IR (for
  * example, variant management), it should use nir_shader_clone().
  */
 struct pipe_shader_state
@@ -904,7 +904,7 @@ struct pipe_compute_state
 
 /**
  * Structure that contains a callback for debug messages from the driver back
- * to the state tracker.
+ * to the gallium frontend.
  */
 struct pipe_debug_callback
 {
@@ -916,7 +916,7 @@ struct pipe_debug_callback
 
    /**
     * Callback for the driver to report debug/performance/etc information back
-    * to the state tracker.
+    * to the gallium frontend.
     *
     * \param data       user-supplied data pointer
     * \param id         message type identifier, if pointed value is 0, then a
@@ -935,7 +935,7 @@ struct pipe_debug_callback
 
 /**
  * Structure that contains a callback for device reset messages from the driver
- * back to the state tracker.
+ * back to the gallium frontend.
  *
  * The callback must not be called from driver-created threads.
  */
index 38255048d94380b3a555a93c1c88f8d13bcb9ee9..5ca587a6eb07823e4516ccc0e7d2d0504ea26fb1 100644 (file)
@@ -104,7 +104,7 @@ struct pipe_video_codec
 
    /**
     * flush any outstanding command buffers to the hardware
-    * should be called before a video_buffer is acessed by the state tracker again
+    * should be called before a video_buffer is acessed by the gallium frontend again
     */
    void (*flush)(struct pipe_video_codec *codec);
 
index 40e77354e9a07ee51f5a5fba9f7ff37cccc63f2c..fd7b0aee3ef6b0cc5b65e4f788e1a21c300fb027 100644 (file)
@@ -118,7 +118,7 @@ gdi_present(struct pipe_screen *screen,
             HDC hDC)
 {
    /* This will fail if any interposing layer (trace, debug, etc) has
-    * been introduced between the state-trackers and the pipe driver.
+    * been introduced between the gallium frontends and the pipe driver.
     *
     * Ideally this would get replaced with a call to
     * pipe_screen::flush_frontbuffer().
index 830cd150fab4ab5ba6dc7da288be62e441d2e021..cb2b9f83a3ab360f23cde66656ede74ad7804b31 100644 (file)
@@ -2,7 +2,7 @@ These directory contains tools for manipulating traces produced by the trace
 pipe driver.
 
 
-Most debug builds of state trackers already load the trace driver by default.
+Most debug builds of gallium frontends already load the trace driver by default.
 To produce a trace do
 
   export GALLIUM_TRACE=foo.gtrace
@@ -34,6 +34,6 @@ You can compare two JSON files by doing
 
   ./diff_state.py foo.json boo.json | less
 
-If you're investigating a regression in a state tracker, you can obtain a good
+If you're investigating a regression in an gallium frontend, you can obtain a good
 and bad trace, dump respective state in JSON, and then compare the states to
 identify the problem.
index 8b50350fabba1ebf64d9c17acfb6c1f85df9a292..315564b6fca311baee7cb26cabb0934824e5898b 100644 (file)
@@ -45,8 +45,8 @@ static void st_viewport(struct gl_context *ctx)
       return;
 
    /*
-    * Normally we'd want the state tracker manager to mark the drawables
-    * invalid only when needed. This will force the state tracker manager
+    * Normally we'd want the frontend manager to mark the drawables
+    * invalid only when needed. This will force the frontend manager
     * to revalidate the drawable, rather than just update the context with
     * the latest cached drawable info.
     */
index cc1572bcc316aa1f2a15e4bf128f967290182f64..ab2bfbc1f3959395e3b57e9a5ad52491878e0057 100644 (file)
@@ -1248,7 +1248,7 @@ st_manager_add_color_renderbuffer(struct st_context *st,
    st_framebuffer_update_attachments(stfb);
 
    /*
-    * Force a call to the state tracker manager to validate the
+    * Force a call to the frontend manager to validate the
     * new renderbuffer. It might be that there is a window system
     * renderbuffer available.
     */
index f29020e15b835c129e318cfa71b1ee85ddf1047d..cb429e4f8c0bf46e86cf5dc8088e92fc244778ed 100644 (file)
@@ -94,7 +94,7 @@ panfrost_format_supports_afbc(enum pipe_format format)
 
         /* Z32/Z16/S8 are all compressible as well, but they are implemented as
          * Z24S8 with wasted bits. So Z24S8 is the only format we actually need
-         * to handle compressed, and we can make the state tracker deal with
+         * to handle compressed, and we can make the gallium frontend deal with
          * the rest. */
 
         if (format == PIPE_FORMAT_Z24_UNORM_S8_UINT)
index a09218a39021338450ed30d3c183b94f0ad27705..0e071e5d7bf8c2381ad55e01a20a5ac0cc65d2a9 100644 (file)
@@ -25,7 +25,7 @@ usage: merge_driinfo.py <list of input files>
 
 Generates a source file which contains the DRI_CONF_xxx macros for generating
 the driinfo XML that describes the available DriConf options for a driver and
-its supported state trackers, based on the merged information from the input
+its supported gallium frontends, based on the merged information from the input
 files.
 """