HOW-TO:Modify dirty regions

From Official Kodi Wiki
Revision as of 23:24, 23 December 2012 by Ned Scott (talk | contribs)
Jump to navigation Jump to search

Dirty regions can help speed up the GUI in XBMC and decrease the demand on your CPU and GPU. Dirty regions has no effect during video playback unless there are GUI elements (on screen buttons) visible. Using dirty regions requires XBMC v11 (Eden) or higher.

XBMC started as a project for the original XBOX where things were very different. After the move to desktops and embedded environments, many of the legacy procedures remained. One of these procedures, and a long-time thorn in XBMC’s side has long been its rendering model in which where every frame is rendered by the GPU in its entirety, typically at 60fps. As you can imagine, this is incredibly intensive and very unfriendly to low-power platforms. This is where dirty-region rendering comes in. Thanks to the work of Tobias and Jonathan (jmarshall), XBMC now has the ability to only render what has changed.

For more information see: Working with dirty regions

Modes

"Mode" 3 is currently enabled by default (as of XBMC v12), as it will reduce CPU/GPU usage without causing any flickering in the graphics. However Mode 3 will not make the GUI any faster. For that you will need mode 1 or 2. Mode 1 will provide the greatest speedup.

Some GPU/hardware configurations will have some minor issues (such as a visual "flicker"), so for those situations try mode 2 or use the default (mode 3, which requires no advancedsetting).

Example

This example is probably the setting that most users will want to try if they want to increase the GUI speed. As noted above, if you have issues you might want to try this same setting with mode 2 or 3:

1. Create a text document and save it as advancedsettings.xml (or edit the existing one if you've already made it)
2. Cut and paste the following into your new advancedsettings.xml file:
<advancedsettings>
 <gui>    
   <algorithmdirtyregions>1</algorithmdirtyregions>
   <nofliptimeout>1000</nofliptimeout>
 </gui>
</advancedsettings>
3. Place your advancedsettings.xml file in your userdata folder.
4. Done!

Technical notes

From the advancedsettings.xml page:


<algorithmdirtyregions>


<nofliptimeout>