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
|
local leap = require 'leap'
local mapargs = require 'mapargs'
local result_view = require 'result_view'
local function result(keys)
return LL.setdtor(
'LLInventory result',
setmetatable(
-- the basic table wrapped by setmetatable just captures the int
-- result-set {key, length} pairs from 'keys', but with underscore
-- prefixes
{
_categories=keys.categories,
_items=keys.items,
-- call result:close() to release result sets before garbage
-- collection or script completion
close = function(self)
result_view.close(self._categories[1], self._items[1])
end
},
-- The caller of one of our methods that returns a result set
-- isn't necessarily interested in both categories and items, so
-- don't proactively populate both. Instead, when caller references
-- either 'categories' or 'items', the __index() metamethod
-- populates that field.
{
__index = function(t, field)
-- we really don't care about references to any other field
if not table.find({'categories', 'items'}, field) then
return nil
end
-- We cleverly saved the result set {key, length} pair in
-- a field with the same name but an underscore prefix.
local view = result_view(t['_' .. field])
-- cache that view for future reference
t[field] = view
return view
end
}
),
-- When the table-with-metatable above is destroyed, tell LLInventory
-- we're done with its result sets -- whether or not we ever fetched
-- either of them.
function(res)
res:close()
end
)
end
local LLInventory = {}
-- Get the items/folders info by provided IDs,
-- reply will contain "items" and "categories" tables accordingly
function LLInventory.getItemsInfo(item_ids)
return result(leap.request('LLInventory', {op = 'getItemsInfo', item_ids=item_ids}))
end
-- Get the table of folder type names, which can be later used to get the ID of the basic folders
function LLInventory.getFolderTypeNames()
return leap.request('LLInventory', {op = 'getFolderTypeNames'}).names
end
-- Get the UUID of the basic folder("Textures", "My outfits", "Sounds" etc.) by specified folder type name
function LLInventory.getBasicFolderID(ft_name)
return leap.request('LLInventory', {op = 'getBasicFolderID', ft_name=ft_name}).id
end
-- Get the table of asset type names, which can be later used to get the specific items via LLInventory.collectDescendantsIf(...)
function LLInventory.getAssetTypeNames()
return leap.request('LLInventory', {op = 'getAssetTypeNames'}).names
end
-- Get the direct descendants of the 'folder_id' provided,
-- reply will contain "items" and "categories" tables accordingly
function LLInventory.getDirectDescendants(folder_id)
return result(leap.request('LLInventory', {op = 'getDirectDescendants', folder_id=folder_id}))
end
-- backwards compatibility
LLInventory.getDirectDescendents = LLInventory.getDirectDescendants
-- Get the descendants of the 'folder_id' provided, which pass specified filters
-- reply will contain "items" and "categories" tables accordingly
-- LLInventory.collectDescendantsIf{ folder_id -- parent folder ID
-- [, name] -- name (substring)
-- [, desc] -- description (substring)
-- [, type] -- asset type
-- [, limit] -- item count limit in reply, maximum and default is 100
-- [, filter_links]} -- EXCLUDE_LINKS - don't show links, ONLY_LINKS - only show links, INCLUDE_LINKS - show links too (default)
function LLInventory.collectDescendantsIf(...)
local args = mapargs('folder_id,name,desc,type,filter_links,limit', ...)
args.op = 'collectDescendantsIf'
return result(leap.request('LLInventory', args))
end
-- backwards compatibility
LLInventory.collectDescendentsIf = LLInventory.collectDescendantsIf
return LLInventory
|
