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
|
-- Engage the viewer's UI
local leap = require 'leap'
local Timer = (require 'timers').Timer
local mapargs = require 'mapargs'
local UI = {}
-- ***************************************************************************
-- registered menu actions
-- ***************************************************************************
function UI.call(func, parameter)
-- 'call' is fire-and-forget
leap.request('UI', {op='call', ['function']=func, parameter=parameter})
end
function UI.getValue(path)
return leap.request('UI', {op='getValue', path=path})['value']
end
-- ***************************************************************************
-- UI views
-- ***************************************************************************
-- Either:
-- wreq{op='Something', a=1, b=2, ...}
-- or:
-- (args should be local, as this wreq() call modifies it)
-- local args = {a=1, b=2, ...}
-- wreq('Something', args)
local function wreq(op_or_data, data_if_op)
if data_if_op ~= nil then
-- this is the wreq(op, data) form
data_if_op.op = op_or_data
op_or_data = data_if_op
end
return leap.request('LLWindow', op_or_data)
end
-- omit 'parent' to list all view paths
function UI.listviews(parent)
return wreq{op='getPaths', under=parent}
end
function UI.viewinfo(path)
return wreq{op='getInfo', path=path}
end
-- ***************************************************************************
-- mouse actions
-- ***************************************************************************
-- pass a table:
-- UI.click{path=path
-- [, button='LEFT' | 'CENTER' | 'RIGHT']
-- [, x=x, y=y]
-- [, hold=duration]}
function UI.click(...)
local args = mapargs('path,button,x,y,hold', ...)
args.button = args.button or 'LEFT'
local hold = args.hold or 1.0
wreq('mouseMove', args)
wreq('mouseDown', args)
Timer(hold, 'wait')
wreq('mouseUp', args)
end
-- pass a table as for UI.click()
function UI.doubleclick(...)
local args = mapargs('path,button,x,y', ...)
args.button = args.button or 'LEFT'
wreq('mouseDown', args)
wreq('mouseUp', args)
wreq('mouseDown', args)
wreq('mouseUp', args)
end
-- UI.drag{path=, xoff=, yoff=}
function UI.drag(...)
local args = mapargs('path,xoff,yoff', ...)
-- query the specified path
local rect = UI.viewinfo(args.path).rect
local centerx = math.floor(rect.left + (rect.right - rect.left)/2)
local centery = math.floor(rect.bottom + (rect.top - rect.bottom)/2)
wreq{op='mouseMove', path=args.path, x=centerx, y=centery}
wreq{op='mouseDown', path=args.path, button='LEFT'}
wreq{op='mouseMove', path=args.path, x=centerx + args.xoff, y=centery + args.yoff}
wreq{op='mouseUp', path=args.path, button='LEFT'}
end
-- ***************************************************************************
-- keyboard actions
-- ***************************************************************************
-- pass a table:
-- UI.keypress{
-- [path=path] -- if omitted, default input field
-- [, char='x'] -- requires one of char, keycode, keysym
-- [, keycode=120]
-- keysym per https://github.com/secondlife/viewer/blob/main/indra/llwindow/llkeyboard.cpp#L68-L124
-- [, keysym='Enter']
-- [, mask={'SHIFT', 'CTL', 'ALT', 'MAC_CONTROL'}] -- some subset of these
-- }
function UI.keypress(...)
local args = mapargs('path,char,keycode,keysym,mask', ...)
if args.char == '\n' then
args.char = nil
args.keysym = 'Enter'
end
return wreq('keyDown', args)
end
-- UI.type{text=, path=}
function UI.type(...)
local args = mapargs('text,path', ...)
if #args.text > 0 then
-- The caller's path may be specified in a way that requires recursively
-- searching parts of the LLView tree. No point in doing that more than
-- once. Capture the actual path found by that first call and use that for
-- subsequent calls.
local path = UI.keypress{path=args.path, char=string.sub(args.text, 1, 1)}.path
for i = 2, #args.text do
UI.keypress{path=path, char=string.sub(args.text, i, i)}
end
end
end
-- ***************************************************************************
-- Snapshot
-- ***************************************************************************
-- UI.snapshot{filename=filename -- extension may be specified: bmp, jpeg, png
-- [, type='COLOR' | 'DEPTH']
-- [, width=width][, height=height] -- uses current window size if not specified
-- [, showui=true][, showhud=true]
-- [, rebuild=false]}
function UI.snapshot(...)
local args = mapargs('filename,width,height,showui,showhud,rebuild,type', ...)
args.op = 'saveSnapshot'
return leap.request('LLViewerWindow', args).result
end
return UI
|
