TraceCanvas QML Type

Un type de Canvas spécialisé pour le rendu des objets Trace. En savoir plus…

• 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 offre des fonctionnalités permettant d'afficher des objets Trace à l'écran.

Pour que l'affichage 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
}

Ce type propose des options intégrées pour l'affichage des traces. Actuellement, les options d'affichage suivantes sont disponibles :

• renderSmoothedLine Affiche 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

Une fonction de rendu personnalisée est également prise en charge. Prenons l'exemple suivant :

renderFunction: renderCustomLine

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

    ...
}

Documentation des propriétés

autoDestroy : bool

Active le mode d'autodestruction.

S'il est activé, 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’élément 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 lors du recyclage de l'traceCanvas.

Ce signal a été introduit dans Qt 6.1.

Documentation des méthodes

[since 6.1] recycle()

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

La fonction déclenche le signal « onRecycle » une fois l'opération terminée (avant le retour).

La fonction renvoie « true » lorsque le recyclage a 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()

Affiche une ligne lissée aux angles arrondis.

Cette fonction est incrémentielle et ne dessine que la nouvelle partie ajoutée au tracé.

Cette fonction ne modifie aucun des attributs du canevas (ceux-ci peuvent donc être définis ailleurs).