BorderImageMesh QML Type

Définit un maillage dont les sommets sont disposés comme ceux d'un « BorderImage ». En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• border
  • border.bottom : int
  • border.left : int
  • border.right : int
  • border.top : int
• horizontalTileMode : enumeration
• size : size
• verticalTileMode : enumeration

Description détaillée

BorderImageMesh offre des fonctionnalités similaires à celles d'BorderImage à une application ShaderEffect sans nécessiter l'utilisation d'un ShaderEffectSource, qui peut s'avérer coûteux.

Les éléments suivants sont fonctionnellement équivalents :

BorderImage {
    id: borderImage
    border {
        left: 10
        right: 10
        top: 10
        bottom: 10
    }
    source: "myImage.png"
    visible: false
}
ShaderEffectSource {
    id: effectSource
    sourceItem: borderImage
    visible: false
}
ShaderEffect {
    property var source: effectSource
    ...
}

Image {
    id: image
    source: "myImage.png"
    visible: false
}
ShaderEffect {
    property var source: image
    mesh: BorderImageMesh {
        border {
            left: 10
            right: 10
            top: 10
            bottom: 10
        }
        size: image.sourceSize
    }
    ...
}

Mais la version BorderImageMesh peut généralement être mieux optimisée.

Documentation des propriétés

border group

Les 4 lignes de bordure (2 horizontales et 2 verticales) divisent l'image en 9 sections, comme illustré ci-dessous :

Chaque ligne de bordure (gauche, droite, haut et bas) spécifie un décalage en pixels par rapport au bord correspondant de la grille. Par défaut, chaque ligne de bordure a une valeur de 0.

Par exemple, la définition suivante place la ligne inférieure à 10 pixels du bas de la grille :

BorderImageMesh {
    border.bottom: 10
    // ...
}

Cette propriété permet de définir comment répéter ou étirer les parties centrales d'une image.

• BorderImage.Étirer : redimensionne l'image pour l'adapter à la zone disponible.
• BorderImage.Répéter : répète l'image en mosaïque jusqu'à ce qu'il n'y ait plus d'espace. La dernière image peut être recadrée.
• BorderImage.Round : identique à « Repeat », mais redimensionne les images à la baisse pour s'assurer que la dernière image ne soit pas recadrée.

Le mode de mosaïque par défaut pour chaque propriété est « BorderImage » «.Stretch».

size : size

La taille de base de la grille. Elle correspond généralement à l’ sourceSize s de l’image utilisée par l’ ShaderEffect.