User:Claus chr/DPL

    From KDE UserBase Wiki
    Reference: DPL Manual
    See also Pipesmoker's notes and this page of examples
    Example UI on this Template:Catlist page

    All the examples on this page have been commented out to prevent the page from being very slow to load. If you want to see the outcome of a search example, just edit the page and remove the comment tags around the desired example. You don't need to save the page, a preview will give you the search results; that way you can experiment with the examples and easily restore the page to its original state when you are done.

    Searching for pages containing a certain text string

    Text without wiki markup

    Enter {{Search|text}} anywhere to get the search results in the form of links. Here text can be plain text or a perl like regexp. Be careful to escape regexp meta characters. If the searched text contain wiki markup this template may nor give the desired results; see the next section.

    The Search template searches only the main namespace, and only original English pages.

    Example: To find all English pages containing the word application - possibly capitalized enter this:

    {{Search|[Aa]pplication}}

    Information

    The results should just be a link to each page containing the searched text. For some reason, however, some pages include the content at the beginning of the page, typically an info box, an image or tabular material. This can be avoided by ensuring that the pages searched start by <languages />. If the page doesn't have translate tags this directive have no effect, but it prevents the unwanted inclusion of content from the page in the search result.


    Text containing wiki markup

    In case the Search template does not work for you use code like this to accomplish your desired result:

    <DPL>
      namespace = Main
      nottitleregexp = .*((/[a-z][a-z](.|-..)?)|([ _][(][a-z][a-z](...)?[)]))$
      titlematch = A%|B%|C%|D%|E%|F%|G%|H%|I%|J%
      include = *
      includematch = @\{\{Remember\|3=@
      includemaxlength = 0
      format = ,\n* [[%PAGE%|%TITLE%]],,
      resultsheader = There are %TOTALPAGES% pages beginning with A-J
    </DPL>
    <DPL>
      namespace = Main
      nottitleregexp = .*((/[a-z][a-z](.|-..)?)|([ _][(][a-z][a-z](...)?[)]))$
      titleregexp = ^K[A-Z]
      include = *
      includematch = @\{\{Remember\|3=@
      includemaxlength = 0
      format = ,\n* [[%PAGE%|%TITLE%]],,
      resultsheader = There are %TOTALPAGES% pages beginning with K''X''
    </DPL>
    <DPL>
      namespace = Main
      nottitleregexp = .*((/[a-z][a-z](.|-..)?)|([ _][(][a-z][a-z](...)?[)]))$
      titleregexp = ^K[a-z]
      include = *
      includematch = @\{\{Remember\|3=@
      includemaxlength = 0
      format = ,\n* [[%PAGE%|%TITLE%]],,
      resultsheader = There are %TOTALPAGES% pages beginning with K''x''
    </DPL>
    <DPL>
      namespace = Main
      nottitleregexp = .*((/[a-z][a-z](.|-..)?)|([ _][(][a-z][a-z](...)?[)]))$
      titlematch = L%|M%|N%|O%|P%|Q%|R%|S%|T%|U%|V%|W%|X%|Y%|Z%
      include = *
      includematch = @\{\{Remember\|3=@
      includemaxlength = 0
      format = ,\n* [[%PAGE%|%TITLE%]],,
      resultsheader = There are %TOTALPAGES% pages beginning with L-Z
    </DPL>

    There are 64640 pages beginning with A-J


    Remember

    This page is obsolete and the contents may be harmful to your system


    Warning

    Before making any changes to your system, please read everything carefully and try to understand what you are doing. If you're modifying any files on your system, keep copies of the unmodified version and be sure you can revert to those old version - even if your Xserver is not starting any longer.


    Warning

    Some of the changes mentioned below are said to increase the temperature of your GPU. In any case, monitor your graphic card to make sure it isn't getting too hot!


    Primer

    Several popular graphics cards out there - especially NVIDIA ones - exhibit performance problems with KDE4. These performance hits mostly concern Plasma - the KDE4 desktop - and KWin - the KDE window-manager. Generally speaking this isn't due to KDE4 being unoptimized but a problem with the cards' graphics drivers. Recent Intel laptops also have serious problems at the moment. This page encompasses certain problems that might arise and how to get rid of them.

    General hints

    Graphics drivers

    For both of the big graphics chip manufacturers there different graphics drivers that can be used for each:

    • For NVIDIA cards there's the free nv and the proprietary nvidia driver. While KDE4 should work fine with the former, it doesn't offer 3D acceleration, so the latter may be your only choice. All Most NVIDIA subsections herein only refer to the proprietary driver (there's also a 3rd free driver called nouveau that's currently under development. Unfortunately I don't know how usable it is so far). Due to licensing restrictions most distributions don't install the proprietary driver by default. Please refer to your distribution for information on how to install it.
      • Update: Nvidia has recently issued a new beta driver which is supposed to address most of the performance problems seen with KDE4. It can be downloaded in 64bit and 32bit versions. You need to add some options to your xorg.conf and enable certain feature at runtime, see this post on the NvNews forums for details. Note: Only install beta drivers if you know what you are doing.
      • Update 2: NVIDIA have released a new version 177.68 of beta drivers which fixes a couple of bugs and should improve performance with the KDE 4 OpenGL compositing manager. More info and downloads here. The latest beta version is 177.70 and it should enhance performance when dragging Plasma applets and fix some text rendering performance and corruptions. More info here.
      • Update 3: NVIDIA's 177.70 version of beta drivers has improved support for RENDER operations with the same source, and destination; this should enhance performance in some situations, e.g. when dragging Plasma applets in KDE4. More info here.
      • Update 4: NVIDIA's 177.80 version of beta drivers out here; some performance problem were fixed.
      • Update 5: NVIDIA's 180.08 version of beta drivers out here; some performance problem were fixed. Also check here for the latest version of beta drivers.
    • For AMD/ATI cards you also have a few options. There are the free "ati" and "radeonhd" drivers for X.org ("ati" is also referred to as "radeon", without "hd", but most xorg driver packages I've seen seem to call it "ati"). Most distributions seem to default to "ati" which is compatible with cards from the earliest Radeons onwards; "RadeonHD", as the name suggests, is only for R500 and later generation cards - in retail model numbers that's the X1300 and later. Both basically should run OK for a standard desktop and they share the same 3D code in mesa so should be similar for desktop effects (note, 3D support for cards newer than R300 is considered unstable and for R600 and later is very experimental). Nonetheless, if you have an X1300 or later card (i.e. one that should be supported by both drivers) and you run in to problems with one it may be worth trying out the other. You also have the option of trying the proprietary fglrx driver, though this has limited support for older cards - there's more on the AMD/ATI website about this option. Some distributions package this or have third party repos that package it and this is likely to be easier than downloading from AMD directly.

    It's usually advisable to stay up-to-date as improvements are being made in the drivers. Thus a first step in improving your KDE4 experience should be checking your current driver and updating if it's outdated. Please refer to your distribution's documentation on how to do that.

    While it might further increase performance, I do NOT recommend installing beta quality drivers because your system's stability will most likely suffer.

    nvidia-settings

    Attributes set using the nvidia-settings utility aren't permanently saved unless it is started as a root user. Login as root in the terminal and start with

    nvidia-settings&

    Otherwise you have to set them every time you restart your Xserver. This can be done conveniently by adding the lines to set the features to your ~/.xinitrc

    nvidia - black window problem

    It seems that older NVidia cards run into the problem that newly opened windows just are drawn as black windows or do not refresh properly anymore. This happens if composite is activated and openGL is used with many windows opened. Maybe the cards are running out of video memory? (The problem does occur with the compiz window manager as well.) In KDE4 you can deactivate composite/effects with Shift + Alt + F12 to continue your work with the desktop normally.

    The problem is that drawing of the window decorations does become very slow if no composite is activated (tested with KDE4.3). As alternative to using openGL as composite engine it is recommended to use XRender in this case. Because moving effects become very slow with XRender you should turn animation speed to instant.

    System Settings

    KDE4's systemsettings allows you to tweak some kwin settings as well. You can find the settings in Desktop -> Desktop Effects -> Advanced Options. Depending on your card either OpenGL or XRender might work better. For OpenGL changing the OpenGL mode might change performance as well. Please bear in mind that changing some of the tweaks mentioned below might force you to change your settings.

    (Note from user): XRender mode helped A LOT on a 6800 GT (agp) with the proprietary driver, especially while looking at videos (177.80).

    Examples:

    • Setting InitialPixmapPlacement to 2 might improve plasma's performance but might make kwin hang sometimes.
    • Setting OpenGL mode to Shared Memory might make kwin more responsive again.
    • (note from a user) Not selecting "Use Vsync" helped a lot in a gforce 6800 (and also on a GeForce 8400M GT).

    If for some reason your Xserver hangs after hitting the Apply button on the dialog and your settings get reverted because you can't confirm your changes in time, try again. Usually it will be faster on one of the subsequent tries. If it doesn't you can still change your settings in ~/.kde4/share/config/kwinrc.

    XGL

    If after installing the NVIDIA's 177.80 versions beta drivers you're still experiencing bad performance (especially on 8xxx-9xxx series) you can install XGL xserver. Please refer to your distribution's documentation on how to do that.

    Note

    XGL has *a lot* of issues regarding 3d applications, xvideo and keyboard layout but, with certain video cards, is now the unique way to enjoy KDE4 at full speed. XGL actually 'bypass' the nvidia driver using the mesa library to render the desktop. OpenGL-based desktop effects cannot be run on XGL.


    Fedora 10 (and later) and xorg.conf (for some users)

    Some of the tweaks mentioned in this article are targeted at a file normally found in most distros at /etc/X11/xorg.conf

    Some users on Fedora 10, however, may find that this file is no longer present by default (depending on their card- anyone with more details on this please feel free to elaborate), and so it must be re-created. To do this, either:

    GUI-friendlier method:

    • install and run the 'system-config-display' package (hitting OK after you're done configuring will generate the xorg.conf file).

    Less GUI-friendly method:

    1. open a command prompt
    2. switch to runlevel 1 by running the command (as root):
      init 1
    3. run
      Xorg -configure
      as root (once you're done, this will generate the xorg.conf file), or you can do
      sudo Xorg -configure :1
      without switching runlevel

    Problems

    This section summarizes several symptoms you might encounter and tries to explain possible causes.

    Resizing certain windows is choppy

    • Explanation : This might be due to your card advertising ARGB Visuals (basically translucency) without having proper support for them. Applications/windows concerned are the Plasma Desktop, the KRunner dialog (Alt + F2), Plasma's Add new widget dialog or a konsole window.
    • Test : If you want to make sure this issue is a problem for you, run
      XLIB_SKIP_ARGB_VISUALS=1 konsole
      on the command-line and try to resize the new konsole window (setting the environment variable XLIB_SKIP_ARGB_VISUALS turns off ARGB visuals). If it resizes without problems, then this is certainly one of the problems you're facing.

    Note

    I have found that this fixes Dolphin's preview delay too for me. Please confirm. --dpalacio 17:33, 27 July 2008 (CEST)


    Your graphics card struggles with Flash video

    If you have an older graphics card, hardware acceleration may be a struggle for it. This may be particularly obvious when watching flash videos such as Youtube videos. This may help:

    • While viewing a 'Flash' video right-click on the video 'screen'.
    • A menu will appear with 'settings' and 'check-boxes'.
    • If you choose the 'global settings' (near the bottom) it takes you a box for the 'global settings'.
    • There you can turn off hardware acceleration for Flash

    General

    • You can set the BackingStore options in your xorg.conf:

    In the Section "Device"

        ...
        Option "BackingStore" "true"
        ...
    EndSection "Device"
    This works for some (eg. konsole) but unfortunately not all windows.
    • As a last resort you can try setting
      XLIB_SKIP_ARGB_VISUALS=1
      in your ~/.xinitrc but this isn't pretty.

    NVIDIA

    • You can set the IntialPixmapPlacement with the nvidia-settings utility:
    $ nvidia-settings -a InitialPixmapPlacement=2
    This works for some (but unfortunately not all) NVIDIA cards.

    NV/Intel

    • You can enable EXA Acceleration in the xorg.conf
    Section "Device"
        ...
        Option "AccelMethod" "EXA"
    # optional, may improve performance but introduce visible artifacts
    #    Option "MigrationHeuristic" "greedy" 
        ...
    EndSection "Device"

    Performance will be somewhat better on older X servers (<=1.4.2) and significantly better on the latest prerelease X servers (>=1.4.99.901) with this option.

    • The problem with poor effects performance also can be overcome by using Intel video drivers 2.6.3.1 ( in my case deb based distro ) or higher, with kernel 2.6.30-rc1 or higher verion, with enabled UXA in xorg.conf like this :

    NOTE: If you use kernel 2.6.29, there is many bugs and xorg freeze randomly with enabled UXA extension.

    Section "Device"
            Identifier      "Generic Video Card"
            Driver          "intel"
            Option "AccelMethod" "UXA"
    EndSection

    With this config, my i945G with PentiumD820, makes 350-500 FPS in Glxgears, and all effects runs perfect with Opengl render.

    ATI

    TODO

    Plasma performance is bad

    • Explanation : Unfortunately the reasons for plasma being choppy seem to be numerous so it's hard to tell where your choppiness comes from.
    • Test : Usually plasma performance problems can be seen best on the Folder View plasmoid. Moving it or scrolling inside the folder might be pretty slow.

    General

    • Please make sure this is not (only) related to the ARGB Visuals mentioned in the above section.

    NVIDIA

    • You can set the IntialPixmapPlacement and the GlyphCache option with the nvidia-settings utility:
      $ nvidia-settings -a InitialPixmapPlacement=2 -a GlyphCache=1
      This works for some (but unfortunately not all) NVIDIA cards. Some cards reportedly work better using
      InitialPixmapPlacement=1
      or maybe even
      InitialPixmapPlacement=3
    • Options that are said to work well on 8xxx cards but are untested (by me)
      • Option "RenderAccel" "True"
        • enabled by default
      • Option "TripleBuffer" "True"
        • Enables triple buffering. "Decreases the time an application stalls while waiting for vblank events, but increases latency slightly" (NVIDIA Readme)
      • Option "DamageEvents" "True"
        • Recommended by NVIDIA if running composite+glx, increases performance, enabled by default
      • Option "UseCompositeWrapper" "True"
        • Enables the X server's composite wrapper instead of the builtin one.
      • Option "AllowIndirectPixmaps" "True"
        • Could improve hardware rendering on G80+ cards with more than 256 MB of video memory.
      • Option "BackingStore" "True"
        • Cache overlayed areas in case they get redisplayed later
      • Option "PixmapCacheSize" "200000"
        • allocate said number of pixels for pixmap caches
      • Option "OnDemandVBlankInterrupts" "True"
        • only fire VBlank interrupts in modes where they are needed

    ATI

    TODO

    Folder View and other plasmoids look badly rendered

    • Explanation : Folder View' and some other widgets use hardware accelerated rendering. There are two methods to do this, and Plasma requires the newer EXA method.
    • Test : This is best seen on the Folder View widget, which will appear as a distorted and seemingly random region on the screen.

    Open Source radeon driver

    The Open Source radeon driver uses the XAA acceleration method by default. So you need to change the acceleration method from XAA (X Acceleration Architecture) to the newer EXA. As this involves editing your xorg.conf file, bear in mind that if you make an error, it may result in X not starting on your system, so first save a copy of the existing xorg.cong file.

    To make the switch, edit your xorg.conf file. Locate the Device section for your graphics card. Before the "EndSection" line, add

    Option "AccelMethod" "EXA"


    If there is already a line with AccelMethod, change it from XAA to EXA. Save the file and restart the X server.

    Note that using EXA may result in some older applications, such as some KDE3 programs being rendered incorrectly.

    When using EXA it is strongly recommended to use a recent X server, at least 1.6.x or even better the new 1.7 release -- perhaps best to wait for 1.7.1.

    If you have an AGP-based card then you may also want to add the following line at the same location into the configuration file.

    Option "AccelDFS"    "true"

    This should accelerate the driver even more, but may get you a hardlock when starting X. So be cautious with this option. See this article for more information on this topic.

    Some things that may speed up any card's performance

    The first one refers particularly to systems running KDE prior to 4.3.1 -

    • Try to avoid using many widgets on your desktop, particularly if they are of the dynamic updating type.
    • Turn off transparency/translucency, choosing themes that don't use it.
    • Use a theme with transparency, but change the configuration. Set the fade time to zero.
      • There are two ways to do this, both in the desktop-effects systemsettings dialog. One, on the General tab, set animation speed to Instant.
      • Two, on the All Effects tab, find translucency, configure it, and set fading duration to 0 to 10 or so. (The spinner increments are 100 ms, so the 10 ms suggestion is only a tenth of that.)

    These hints won't turn an old graphics card into a fast one, but they will make Desktop Effects a feasibility on many older cards.

    Desktop Effects causes random freezes

    This seems to affect Intel and ATi cards. AccelMethod seems to be the culprit. The default acceleration path for most drivers right now is the outdated and slower XAA (Option "AccelMethod" "XAA") which is not recommended anymore, especially with compositing. Unfortunately, the proprietary binary blobs of ATI and NVidia still only support XAA

    ATi

    Try enabling EXA acceleration by adding these two lines to xorg.conf

    Section "Device"
       Option      "UseAtomBIOS" "true"
       Option      "AccelMethod" "EXA"
       # ...
    EndSection

    This works with both the radeon as well as the radeonhd driver but only with cards up to an X1950. HD2xxx and above aren't supported yet.

    AtomBIOS is automatically used by the radeon driver, so that line will need to be commented out. If you have the radeonhd driver, however, you will need it. EXA is expected to become the default in the near future, but having it specified here is unlikely to cause any problems even then. 3D and EXA support for HD2xxx and above is expected later this year (2009) as they are already in an experimental branch.

    Intel

    It's worth checking Xorg.0.log for mention of EXA. If you don't find it (or UXA) try adding the EXA line as described in the ATi section. UXA is an experimental option, but only supported by a few drivers. It's likely that the best bits will be merged into EXA soon.

    Phoronix forums is a good place to read more about this.

    KRunner (Alt+F2) looks strange

    NVIDIA

    KRunner display problems
    KRunner display problems

    On NVIDIA cards krunner's dialog might appear several times below each other (with only the topmost one editable). This is related to setting InitialPixmapPlacement=1 as recommended above. There's currently no known way to remedy this problem. However, it only appears on one relatively early version of KDE 4.

    Most of the icons in your SysTray have disappeared

    At some point you may have been told to add KDE_SKIP_ARGB_VISUALS to either ~/.bash_profile, /etc/profile or in ~/.profile. If that rings a bell for you, hunt for it and comment it out. You may find that they magically re-appear. Otherwise, check the Qt4 libraries you are using. In my case I needed Qt 4.4.3 together with KDE 4.2.


    Links/References

    -- Performance tweaks to the 177.67 Nvidia beta driver
    -- Thread about graphics issues on the NVIDIA forums.
    Notes on using External Sound Cards

    There are 22522 pages beginning with KX

    There are 30545 pages beginning with Kx

    There are 50307 pages beginning with L-Z

    Normally, you'd want to copy all of this into your page and modify the includematch lines to the pattern you want to search for. Note the two @-characters; they mark the beginning and end of the actual search pattern. You can use any character instead of @ as long as it does not appear in the actual pattern.

    Note

    Some characters such as ¤ do not work as pattern delimiters; perhaps only ASCII characters can be used?


    If you want to search other namespaces than Main, just change that line. The nottitleregexp lines filters out all translated pages including lingering old style translations and should not be touched. The titlematch lines are needed to split up the search into manageable chunks. There is a maximum of pages that can be handled by the includematch search; if too many pages pass through the title filters the first ones up to the maximum number will be searched; the rest will be silently ignored! Currently, the maximum seems to be 1000. The include and includemaxlength should never be modified.


    Be careful

    The rest of the examples should be modified to take recent insights into consideration. See the above.


    Searching for pages that hasn't been marked for translation

    <DPL>
      nottitlematch = %/__|%/zh-%|%pt-%|%(%)
      namespace = Main
      include = *
      includenotmatch = /<languages/
      includemaxlength = 0
      resultsheader = Danish translation units containing the string "applikation"
      format = ,\n* [[%PAGE%|%TITLE%]]\n,,
    </DPL>
    

    Find discussion threads contributed by a user

    Perhaps more talk namespaces needs to be searched.

    <DPL>
      namespace = Talk | Thread
      createdby = AmirHP
    </DPL>
    


    All English manual pages

    <DPL>
      titlematch = %/Manual%
      nottitlematch = %/__|%/__-__|%/___|% (%
      namespace = | User | Draft
      resultsheader = Manual Pages:
      format = ,\n* [[%PAGE%|%TITLE%]]\n,,
    </DPL>
    


    All English pages linking to a given page

    The LinksTo template is describes and tested here: User:Claus_chr/DPL/Test

    Warning

    This query seems to be affected by the same problem as the plain text query (above).



    Kopete Subpages in 3 columns

    <DPL>
      titlematch = Kopete/%
      notnamespace = Translations
      columns = 3
      format = ,\n* [[%PAGE%|%TITLE%]],,
    </DPL>

    Akonadi Subpages in Danish

    <DPL>
      titlematch = Akonadi%/da
      notnamespace = Translations
      format = ,\n* [[%PAGE%|%TITLE%]],,
    </DPL>

    Archived pages

    <DPL>
      titlematch = %
      namespace = Archive
      columns = 2
      format = ,\n* [[%PAGE%|%TITLE%]],,
      resultsheader = There are %TOTALPAGES% pages in the Archive namespace. These are:\n
    </DPL>

    NoIndexed pages

    <DPL>
      titlematch = %
      category = Noindexed_pages
      columns = 2
      format = ,\n* [[%PAGE%|%TITLE%]],,
      resultsheader = There are %TOTALPAGES% pages in the Archive namespace. These are:\n
    </DPL>

    Ignoring Deleted Pages

    "As for DPL. If you hit a page with ?action=purge attached to the URL (i.e. http://en.wikinews.org/wiki/Template:Latest_news?action=purge ), it will dump all the removed pages."

    Remaining old-style translations

    <DPL>
      titlematch = %_(%)
      notcategory = Template
      notnamespace = Thread
      notnamespace = Summary
      columns = 2
      format = ,\n* [[%PAGE%|%TITLE%]],,
      resultsheader = There are %TOTALPAGES% pages (partly) remaining in old-style translations. These are:\n
    </DPL>

    Pages with old i18n bar

    <DPL>
      titlematch = %
      namespace = Main
      uses = Template:I18n/Language Navigation Bar
      columns = 3
      format = ,\n* [[%PAGE%|%TITLE%]],,
      resultsheader = There are %TOTALPAGES% pages that still display the old i18n language bar\n
    </DPL>

    Pages with old i18n bar but w/o old-way-translated ones

    <DPL>
      nottitlematch = %_(%)
      namespace = Main
      uses = Template:I18n/Language Navigation Bar
      columns = 3
      format = ,\n* [[%PAGE%|%TITLE%]],,
      resultsheader = There are %TOTALPAGES% relevant pages that still display the old i18n language bar\n
    </DPL>

    Pages not updated since 1st July 2010

    <DPL>
      namespace = Main
      lastrevisionbefore = 201007010000
      columns = 2
      ordermethod=lastedit
      format = ,\n* (%DATE%) [[%PAGE%|%TITLE%]],,
      resultsheader = There are %TOTALPAGES% pages without recent updates\n
    </DPL>

    Listing Non-Translation Pages

    <DPL>
      nottitlematch = %/__|%/zh-%|%(%)
      titlematch = Amarok%
      namespace = Main
      columns = 1
      format = ,\n* [[%PAGE%|%TITLE%]],,
      resultsheader = There are %TOTALPAGES% Amarok pages, not counting translations\n
    </DPL>

    List all pages in a specific namespace

    <DPL>
      nottitlematch = %/__|%/zh-%|%pt-%|%(%)
      namespace = MediaWiki
      columns = 3
      format = ,\n* [[%PAGE%|%TITLE%]],,
      resultsheader = These %TOTALPAGES% pages are in the Mediawiki namespace\n
    </DPL>

    To count translated pages in a specific language:

    <DPL>
      titlematch = %/en
      notnamespace = Translations
      columns = 3
      format = ,\n* [[%PAGE%|%TITLE%]],,
      resultsheader = There are %TOTALPAGES% pages (partly) translated to English. These are:\n
    </DPL>