1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
|
// Copyright (C) 2016 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
import QtQuick
import "TraceUtils.js" as TraceUtils
import QtQuick.VirtualKeyboard
/*!
\qmltype TraceCanvas
\inqmlmodule QtQuick.VirtualKeyboard.Styles
\brief A specialized Canvas type for rendering Trace objects.
\ingroup qmlclass
\ingroup qtvirtualkeyboard-styles-qml
\inherits Canvas
\since QtQuick.VirtualKeyboard 2.0
This type provides capabilities for rendering Trace objects on the screen.
To make the Trace rendering available in the keyboard, this type must be
declared as the \l {KeyboardStyle::traceCanvasDelegate}
{KeyboardStyle.traceCanvasDelegate} component.
\code
traceCanvasDelegate: TraceCanvas {
}
\endcode
Custom drawing attributes can be initialized in the Canvas.available
signal. For example:
\code
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
}
\endcode
The type offers built-in options for Trace rendering. Currently
the following rendering options are available:
\list
\li \c renderSmoothedLine Renders smoothed line with round corners (the default)
\endlist
The rendering function can be changed with the renderFunction property.
\code
renderFunction: renderSmoothedLine
\endcode
Custom rendering function is also supported. Consider the following example:
\code
renderFunction: renderCustomLine
function renderCustomLine() {
getContext("2d")
var points = trace.points()
...
}
\endcode
*/
Canvas {
id: canvas
/*! Provides access to \l Trace object.
*/
property Trace trace
/*! Enables auto destruction mode.
If enabled, this item will be destroyed when the \c trace object is
destroyed.
The default value is false. In this case the canvas can be reused after
onRecycle signal is triggered.
*/
property bool autoDestroy
/*! Specifies the approximate delay in milliseconds, counted from the beginning of the
auto destruction, before the object is to be destroyed or recycled.
This delay makes it possible, for example, to animate the item before destruction.
The default value is 0.
*/
property int autoDestroyDelay
/*! This property defines the rendering function.
The default value is \c renderSmoothedLine
*/
property var renderFunction: renderSmoothedLine
property int __renderPos
property bool __renderingEnabled
/*! Renders smoothed line with round corners.
This function is incremental and renders only the new part added to the Trace.
This function does not alter any of the canvas attributes (i.e. they can be set elsewhere.)
*/
function renderSmoothedLine() {
__renderPos = TraceUtils.renderSmoothedLine(getContext("2d"), trace, __renderPos)
}
/*! Clears screen and resets the rendering.
\since QtQuick.VirtualKeyboard.Styles 6.1
*/
function renderClear() {
var ctx = getContext("2d")
ctx.clearRect(0, 0, width, height)
__renderPos = 0
}
/*! Recycles trace canvas by clearing all drawings and resetting the variables.
The function triggers onRecycle signal after completed (before the return).
The function returns true when recycling is successful.
\since QtQuick.VirtualKeyboard.Styles 6.1
*/
function recycle() {
if (!available) {
destroy()
return false
}
trace = null
recycleTimer.stop()
opacity = Qt.binding(function() {
return trace ? trace.opacity : 1.0
})
requestAnimationFrame(renderClear)
onRecycle(canvas)
return true
}
/*! Emitted when the \a traceCanvas is recycled.
\since QtQuick.VirtualKeyboard.Styles 6.1
*/
signal onRecycle(var traceCanvas)
Timer {
id: recycleTimer
interval: canvas.autoDestroyDelay
onTriggered: canvas.recycle()
}
onTraceChanged: {
if (trace === null) {
if (autoDestroy || !available)
destroy(autoDestroyDelay)
else
recycleTimer.restart()
}
}
onAvailableChanged: {
__renderingEnabled = available
if (__renderingEnabled)
requestAnimationFrame(renderFunction)
}
Connections {
target: canvas.__renderingEnabled && trace ? trace : null
function onLengthChanged() { if (renderFunction) canvas.requestAnimationFrame(renderFunction) }
function onFinalChanged() { if (renderFunction) canvas.requestAnimationFrame(renderFunction) }
}
opacity: trace ? trace.opacity : 1.0
Behavior on opacity {
NumberAnimation {
duration: 1500
easing.type: Easing.InOutQuad
}
}
}
|
