TraceCanvas QML Type

Un tipo de lienzo especializado para renderizar objetos Trace. Más...

• Lista de todos los miembros, incluyendo los heredados

Propiedades

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

Señales

• onRecycle(var traceCanvas) (since 6.1)

Métodos

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

Descripción detallada

Este tipo proporciona capacidades para renderizar objetos Trace en la pantalla.

Para que la renderización de Trace esté disponible en el teclado, este tipo debe declararse como el componente KeyboardStyle.traceCanvasDelegate.

traceCanvasDelegate: TraceCanvas {
}

Los atributos de dibujo personalizados se pueden inicializar en la señal Canvas.available. Por ejemplo:

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
}

El tipo ofrece opciones incorporadas para la renderización de Trace. Actualmente están disponibles las siguientes opciones de renderizado:

• renderSmoothedLine Renderiza línea suavizada con esquinas redondeadas (por defecto).

La función de renderizado puede cambiarse con la propiedad renderFunction.

renderFunction: renderSmoothedLine

También se admite la función de renderizado personalizada. Considere el siguiente ejemplo:

renderFunction: renderCustomLine

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

    ...
}

Documentación de la propiedad

autoDestroy : bool

Activa el modo de autodestrucción.

Si se activa, este elemento se destruirá cuando se destruya el objeto trace.

El valor por defecto es false. En este caso, el lienzo puede reutilizarse después de que se active la señal onRecycle.

autoDestroyDelay : int

Especifica el retardo aproximado en milisegundos, contados desde el inicio de la autodestrucción, antes de que el objeto sea destruido o reciclado.

Este retardo permite, por ejemplo, animar el objeto antes de su destrucción.

El valor por defecto es 0.

renderFunction : var

Esta propiedad define la función de renderizado.

El valor por defecto es renderSmoothedLine

trace : Trace

Proporciona acceso al objeto Trace.

Documentación de señales

[since 6.1] onRecycle(var traceCanvas)

Se emite cuando se recicla traceCanvas.

Esta señal se introdujo en Qt 6.1.

Documentación del método

[since 6.1] recycle()

Recicla el lienzo de trazado borrando todos los dibujos y reseteando las variables.

La función dispara la señal onRecycle después de completarse (antes del retorno).

La función devuelve true cuando el reciclado tiene éxito.

Este método se introdujo en Qt 6.1.

[since 6.1] renderClear()

Limpia la pantalla y reinicia el renderizado.

Este método se introdujo en Qt 6.1.

renderSmoothedLine()

Renderiza la línea suavizada con esquinas redondeadas.

Esta función es incremental y renderiza sólo la parte nueva añadida al Trazado.

Esta función no altera ninguno de los atributos del lienzo (es decir, pueden establecerse en otro lugar).