Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Classes principales  ·  Annotées  ·  Classes groupées  ·  Modules  ·  Fonctions  · 

ShaderEffectSource

The ShaderEffectSource element renders a QML element into a texture and displays it. More...

Inherits Item

This type was introduced in Qt 5.0.

Properties

Methods

Detailed Description

The ShaderEffectSource element renders sourceItem into a texture and displays it in the scene. sourceItem is drawn into the texture as though it was a fully opaque root element. Thus sourceItem itself can be invisible, but still appear in the texture.

ShaderEffectSource can be used as:

  • a texture source in a ShaderEffect. This allows you to apply custom shader effects to any QML element.
  • a cache for a complex element. The complex element can be rendered once into the texture, which can then be animated freely without the need to render the complex element again every frame.
  • an opacity layer. ShaderEffectSource allows you to apply an opacity to elements as a group rather than each element individually.

[Missing image declarative-shadereffectsource.png]

 import QtQuick 2.0

 Rectangle {
     width: 200
     height: 100
     gradient: Gradient {
         GradientStop { position: 0; color: "white" }
         GradientStop { position: 1; color: "black" }
     }
     Row {
         opacity: 0.5
         Item {
             id: foo
             width: 100; height: 100
             Rectangle { x: 5; y: 5; width: 60; height: 60; color: "red" }
             Rectangle { x: 20; y: 20; width: 60; height: 60; color: "orange" }
             Rectangle { x: 35; y: 35; width: 60; height: 60; color: "yellow" }
         }
         ShaderEffectSource {
             width: 100; height: 100
             sourceItem: foo
         }
     }
 }

\endrow

The ShaderEffectSource element does not redirect any mouse or keyboard input to sourceItem. If you hide the sourceItem by setting visible to false or opacity to zero, it will no longer react to input. In cases where the ShaderEffectSource is meant to replace the sourceItem, you typically want to hide the sourceItem while still handling input. For this, you can use the hideSource property.

Note: If sourceItem is a Rectangle with border, by default half the border width falls outside the texture. To get the whole border, you can extend the sourceRect.

Note: The ShaderEffectSource relies on FBO multisampling support to antialias edges. If the underlying hardware does not support this, which is the case for most embedded graphics chips, edges rendered inside a ShaderEffectSource will not be antialiased. One way to remedy this is to double the size of the effect source and render it with smooth: true. This will be equivalent to 4x multisampling, at the cost of lower performance and higher memory use.

Warning: In most cases, using a ShaderEffectSource will decrease performance, and in all cases, it will increase video memory usage. Rendering through a ShaderEffectSource might also lead to lower quality since some OpenGL implementations support multisampled backbuffer, but not multisampled framebuffer objects.

Property Documentation

format : enumeration

This property defines the internal OpenGL format of the texture. Modifying this property makes most sense when the element is used as a source texture of a ShaderEffect. Depending on the OpenGL implementation, this property might allow you to save some texture memory.

Note: Some OpenGL implementations do not support the GL_ALPHA format.


hideSource : bool

If this property is true, the sourceItem is hidden, though it will still be rendered into the texture. As opposed to hiding the sourceItem by setting visible to false, setting this property to true will not prevent mouse or keyboard input from reaching sourceItem. The property is useful when the ShaderEffectSource is anchored on top of, and meant to replace the sourceItem.


live : bool

If this property is true, the texture is updated whenever the sourceItem updates. Otherwise, it will be a frozen image, even if sourceItem is assigned a new element. The property is true by default.


mipmap : bool

If this property is true, mipmaps are generated for the texture.

Note: Some OpenGL ES 2 implementations do not support mipmapping of non-power-of-two textures.


recursive : bool

Set this property to true if the ShaderEffectSource has a dependency on itself. ShaderEffectSources form a dependency chain, where one ShaderEffectSource can be part of the sourceItem of another. If there is a loop in this chain, a ShaderEffectSource could end up trying to render into the same texture it is using as source, which is not allowed by OpenGL. When this property is set to true, an extra texture is allocated so that ShaderEffectSource can keep a copy of the texture from the previous frame. It can then render into one texture and use the texture from the previous frame as source.

Setting both this property and live to true will cause the scene graph to render continuously. Since the ShaderEffectSource depends on itself, updating it means that it immediately becomes dirty again.


sourceItem : Item

This property holds the element to be rendered into the texture. Setting this to null while live is true, will release the texture resources.


sourceRect : rect

This property defines which rectangular area of the sourceItem to render into the texture. The source rectangle can be larger than sourceItem itself. If the rectangle is null, which is the default, the whole sourceItem is rendered to texture.


textureSize : size

This property holds the requested size of the texture. If it is empty, which is the default, the size of the source rectangle is used.

Note: Some platforms have a limit on how small framebuffer objects can be, which means the actual texture size might be larger than the requested size.


wrapMode : enumeration

This property defines the OpenGL wrap modes associated with the texture. Modifying this property makes most sense when the element is used as a source texture of a ShaderEffect.

Note: Some OpenGL ES 2 implementations do not support the GL_REPEAT wrap mode with non-power-of-two textures.


Method Documentation

ShaderEffectSource::scheduleUpdate()

Schedules a re-rendering of the texture for the next frame. Use this to update the texture when live is false.


© 2012 Nokia Corporation and/or its subsidiaries. Documentation contributions included herein are the copyrights of their respective owners.


The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.

Documentation sources may be obtained from www.qt-project.org.


Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide. All other trademarks are property of their respective owners. Privacy Policy
Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 5.0-snapshot
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
 
 
Developpez.com

Nous contacter

Participez

Informations légales

 
Services

Forum Qt

Blogs

Hébergement

 
Partenaires

Hébergement Web