xpra icon
Bug tracker and wiki

Changes between Version 1 and Version 2 of Tuning


Ignore:
Timestamp:
02/21/19 08:19:22 (4 weeks ago)
Author:
Antoine Martin
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Tuning

    v1 v2  
    99== Introduction ==
    1010
    11 Using the default settings, the system will do its best to accommodate any type of application, no matter what the network conditions are like.
     11Using the default settings, the system will do its best to accommodate any type of application, no matter what the network conditions are like. Because those heuristics cover a wide range of possibilities, in many cases they may not be optimal (ie: local connections over mmap behave very differently from a remote connection over 3G or wifi: #2037).
    1212
    1313It is often possible to obtain better performance and user experience by configuring the system to be better tuned for its environment and user demands.
     
    2626These hints can be specified using configuration files for matching various window attributes(#1950), or matching more global desktop application categories (#1956). Applications can also set a window property directly to override this (#2023).
    2727
    28 The hints are used to select the picture encoding most appropriate for the type of content to be compressed (#1952), though applications may choose to bypass this logic and set the picture encoding explicitly (#2086). The hints are also used to tune speed / quality / framerate (#2061), or to disable video mode (#2100).
     28The hints are used to select the picture encoding most appropriate for the type of content to be compressed (#1952), though applications may choose to bypass this logic and set the picture encoding explicitly (#2086) and / or set the quality and speed directly (#2077). The hints are also used to tune speed / quality / framerate (#2061, #1135), or to disable video mode (#2100).
    2929
    30 The hints are also passed on to the picture encoders themselves for their own internal tuning (#1699, #2061).
     30The hints are also passed on to the picture encoders themselves for their own internal tuning (#1699, #2061, #1257, #800).
    3131}}}
    3232
     33
     34{{{#!div class="box"
     35== Video Region ==
     36
     37Video compression offers major bandwidth savings and performance improvements over regular picture compression, but these benefits come at a cost: if the region to encode as video is not detected properly then the non-video areas will suffer from: visual degradation, delays, slow auto-refresh, etc
     38It is therefore essential to correctly detect which part of a window needs to be encoded using video compression.
     39Screen updates using video compression are also the only areas that support AV-sync (#835).
     40
     41The heuristics will try very hard to identify the video region correctly (#410, #967), using any hints it can use to improve its chances of success (ie: #2113).
     42
     43But if at all possible, it is best to use an API to set the video region explicitly (#1060, #1401) and to set exclusion zones so we can ignore the window scrollbars (#1295).
     44
     45
     46See also: #2022, #2094, #1951, #999, #1014, #596
    3347}}}