TraceCanvas QML Type

Un type de canevas spécialisé pour le rendu des objets Trace. Plus d'informations...

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

Propriétés

• autoDestroy : bool
• autoDestroyDelay : int
• renderFunction : var
• trace : Trace

Signaux

• onRecycle(var traceCanvas) (since 6.1)

Méthodes

• recycle() (since 6.1)
• renderClear() (since 6.1)
• renderSmoothedLine()

Description détaillée

Ce type permet de rendre les objets Trace à l'écran.

Pour que le rendu de la trace soit disponible dans le clavier, ce type doit être déclaré en tant que composant KeyboardStyle.traceCanvasDelegate.

traceCanvasDelegate: TraceCanvas {
}

Les attributs de dessin personnalisés peuvent être initialisés dans le signal Canvas.available. Par exemple :

onAvailableChanged: {
    if (!available)
        return;
    var ctx = getContext("2d")
    ctx.lineWidth = 8 * scaleHint
    ctx.lineCap = "round"
    ctx.strokeStyle = Qt.rgba(0xFF, 0xFF, 0xFF)
    ctx.fillStyle = ctx.strokeStyle
}

Le type offre des options intégrées pour le rendu de la trace. Les options de rendu suivantes sont actuellement disponibles :

• renderSmoothedLine Rendu d'une ligne lissée avec des coins arrondis (par défaut)

La fonction de rendu peut être modifiée à l'aide de la propriété renderFunction.

renderFunction: renderSmoothedLine

Les fonctions de rendu personnalisées sont également prises en charge. Prenons l'exemple suivant :

renderFunction: renderCustomLine

function renderCustomLine() {
    getContext("2d")
    var points = trace.points()

    ...
}

Propriété Documentation

autoDestroy : bool

Active le mode de destruction automatique.

Si cette option est activée, cet élément sera détruit lorsque l'objet trace sera détruit.

La valeur par défaut est false. Dans ce cas, le canevas peut être réutilisé après le déclenchement du signal onRecycle.

autoDestroyDelay : int

Spécifie le délai approximatif en millisecondes, compté à partir du début de l'autodestruction, avant que l'objet ne soit détruit ou recyclé.

Ce délai permet, par exemple, d'animer l'objet avant sa destruction.

La valeur par défaut est 0.

renderFunction : var

Cette propriété définit la fonction de rendu.

La valeur par défaut est renderSmoothedLine

trace : Trace

Permet d'accéder à l'objet Trace.

Documentation sur les signaux

[since 6.1] onRecycle(var traceCanvas)

Émis lorsque le site traceCanvas est recyclé.

Ce signal a été introduit dans Qt 6.1.

Documentation de la méthode

[since 6.1] recycle()

Recycle la toile de traçage en effaçant tous les dessins et en réinitialisant les variables.

La fonction déclenche le signal onRecycle une fois terminée (avant le retour).

La fonction renvoie true lorsque le recyclage est réussi.

Cette méthode a été introduite dans Qt 6.1.

[since 6.1] renderClear()

Efface l'écran et réinitialise le rendu.

Cette méthode a été introduite dans Qt 6.1.

renderSmoothedLine()

Rend une ligne lissée avec des coins arrondis.

Cette fonction est incrémentale et ne rend que la nouvelle partie ajoutée à la trace.

Cette fonction ne modifie aucun des attributs du canevas (c'est-à-dire qu'ils peuvent être définis ailleurs).