Back to Home

ESO Lua File v101044

libraries/refresh/refresh.lua

[◄ back to folders ]
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
193
194
195
196
197
198
199
200
201
202
203
ZO_Refresh = ZO_InitializingObject:Subclass()
function ZO_Refresh:Initialize()
    self.refreshGroups = {}
    self.currentlyRefreshing = false
end
function ZO_Refresh:AddRefreshGroup(refreshGroup, data)
    data.dirtySingles = {}
    data.wasShown = false
    self.refreshGroups[refreshGroup] = data
end
function ZO_Refresh:RefreshAll(refreshGroup)
    local refreshData = self.refreshGroups[refreshGroup]
    refreshData.allDirty = true
end
function ZO_Refresh:RefreshSingle(refreshGroup, ...)
    local refreshData = self.refreshGroups[refreshGroup]
    if(refreshData.allDirty) then
        return
    end
    local numInList = select("#", ...)
    for _, data in ipairs(refreshData.dirtySingles) do
        local alreadyHaveData = true
        for i = 1, numInList do
            if(data[i] ~= select(i, ...)) then
                alreadyHaveData = false
                break
            end
        end
        if(alreadyHaveData) then
            return
        end
    end
    table.insert(refreshData.dirtySingles, {...})
end
function ZO_Refresh:UpdateRefreshGroups()
    if self.currentlyRefreshing then return end
    self.currentlyRefreshing = true
    for refreshGroup, refreshData in pairs(self.refreshGroups) do
        if(refreshData.IsShown) then
            local dataShown = refreshData.IsShown()
            if(dataShown ~= refreshData.wasShown) then
                refreshData.wasShown = dataShown
                refreshData.RefreshAll()
                refreshData.allDirty = false
                ZO_ClearNumericallyIndexedTable(refreshData.dirtySingles)
            end
        end
        if(refreshData.allDirty or #refreshData.dirtySingles > 0) then
            if(refreshData.IsShown == nil or refreshData.IsShown()) then
                if(refreshData.allDirty) then
                    refreshData.RefreshAll()
                else
                    for _, singleData in ipairs(refreshData.dirtySingles) do
                        refreshData.RefreshSingle(unpack(singleData))
                    end
                end
                refreshData.allDirty = false
                ZO_ClearNumericallyIndexedTable(refreshData.dirtySingles)
            end
        end
    end
    self.currentlyRefreshing = false
end
--Represents a set of nested refresh operations. Each refresh operation should do what the one below it did plus some additional work. The main usecase for this is rebuilding an entire list from scratch vs. just refreshing visible controls.
ZO_OrderedRefreshGroupManager = ZO_InitializingObject:Subclass()
function ZO_OrderedRefreshGroupManager:Initialize()
    self.groupsWaitingForPerFrameClean = {}
    self.OnUpdateCallback = function() self:OnUpdate() end
end
function ZO_OrderedRefreshGroupManager:AddGroupForPerFrameClean(addGroup)
    if next(self.groupsWaitingForPerFrameClean) == nil then
        EVENT_MANAGER:RegisterForUpdate("ZO_OrderedRefreshGroupManager", 0, self.OnUpdateCallback)
    else
        for _, group in ipairs(self.groupsWaitingForPerFrameClean) do
            if group == addGroup then
                return
            end
        end
    end
    table.insert(self.groupsWaitingForPerFrameClean, addGroup)
end
function ZO_OrderedRefreshGroupManager:OnUpdate()
    for _, group in ipairs(self.groupsWaitingForPerFrameClean) do
        group:TryClean()
    end
    ZO_ClearNumericallyIndexedTable(self.groupsWaitingForPerFrameClean)
    EVENT_MANAGER:UnregisterForUpdate("ZO_OrderedRefreshGroupManager")
end
ORDERED_REFRESH_GROUP_MANAGER = ZO_OrderedRefreshGroupManager:New()
ZO_OrderedRefreshGroup = ZO_InitializingObject:Subclass()
ZO_ORDERED_REFRESH_GROUP_AUTO_CLEAN_IMMEDIATELY = "immediately"
ZO_ORDERED_REFRESH_GROUP_AUTO_CLEAN_PER_FRAME = "perFrame"
ZO_ORDERED_REFRESH_GROUP_AUTO_CLEAN_NEVER = "never"
function ZO_OrderedRefreshGroup:Initialize(autoCleanMode)
    self.activeOrActiveFunction = true
    self.dirtyStates = {}
    self.autoCleanMode = autoCleanMode or ZO_ORDERED_REFRESH_GROUP_AUTO_CLEAN_IMMEDIATELY
end
--Clean is only allowed to happen when the group is active
function ZO_OrderedRefreshGroup:SetActive(activeOrActiveFunction)
        self:TryScheduleClean()
    end
end
function ZO_OrderedRefreshGroup:IsActive()
    if type(self.activeOrActiveFunction) == "function" then
        return self.activeOrActiveFunction()
    else
        return self.activeOrActiveFunction
    end
end
--Order goes from 1 to N where 1 should be a full update and successive numbers are smaller and smaller updates
function ZO_OrderedRefreshGroup:AddDirtyState(name, cleanFunction)
    table.insert(self.dirtyStates,
    {
        name = name,
        order = #self.dirtyStates + 1,
        cleanFunction = cleanFunction,
    })
end
function ZO_OrderedRefreshGroup:IsDirty()
    return self.currentDirtyState ~= nil
end
--A function that prevents a state from being dirtied if the function returns false. Receives everything passed to MarkDirty after name. Can be used to filter out certain events.
function ZO_OrderedRefreshGroup:SetDirtyStateGuard(name, guardFunction)
    local dirtyState = self:GetDirtyState(name)
    dirtyState.guardFunction = guardFunction
end
function ZO_OrderedRefreshGroup:GetDirtyState(name)
    for _, dirtyState in ipairs(self.dirtyStates) do
        if dirtyState.name == name then
            return dirtyState
        end
    end
end
--Marks the state dirty and tries to clean it immediately
function ZO_OrderedRefreshGroup:MarkDirty(name, ...)
    local newDirtyState = self:GetDirtyState(name)
    if newDirtyState.guardFunction then
        if not newDirtyState.guardFunction(...) then
            return
        end
    end
    if self.currentDirtyState then
        --if we already have a dirty state that encompasses the new one then ignore it
        if newDirtyState.order < self.currentDirtyState.order then
            self.currentDirtyState = newDirtyState
        end
    else
        self.currentDirtyState = newDirtyState
    end
end
function ZO_OrderedRefreshGroup:TryScheduleClean()
    if self:IsDirty() and self:IsActive() then
        if self.autoCleanMode == ZO_ORDERED_REFRESH_GROUP_AUTO_CLEAN_IMMEDIATELY then
            self:TryClean()
        elseif self.autoCleanMode == ZO_ORDERED_REFRESH_GROUP_AUTO_CLEAN_PER_FRAME then
            ORDERED_REFRESH_GROUP_MANAGER:AddGroupForPerFrameClean(self)
        end
    end
end
--This function can be called manually to clean dirty state that happended when the group wasn't active
function ZO_OrderedRefreshGroup:TryClean()
    if self:IsDirty() and self:IsActive() then
        self.currentDirtyState.cleanFunction()
        self.currentDirtyState = nil
    end
end