Test Extension Proxies

Demonstration/test extension showing how to use newExtensionProxy to fan out extension hooks to multiple object instances.

Overview

util_testExtensionProxies creates an ExtensionProxy that dispatches extension events (like onUpdate) to a list of OOP instances. This is a test/example extension - not used in production.

Extension path: lua/ge/extensions/util/testExtensionProxies.lua

Exports (M)

Internals

ExtensionProxyTester Class

A minimal class with an onUpdate method that prints its id and dtReal.

function ExtensionProxyTester:onUpdate(dtReal, dtSim, dtRaw)
  print('ExtensionProxyTester:onUpdate called: ' .. tostring(self.id) .. ', ' .. tostring(dtReal))
end

ExtensionProxy Pattern

1. Create instances with event-sink methods (e.g., onUpdate).
2. Call newExtensionProxy(M) - binds the proxy to this extension module.
3. Call extProxy:submitEventSinks(instances) - registers instances as event receivers.
4. When the extension receives onUpdate, the proxy fans it out to all instances.
5. On unload, call extProxy:destroy() to clean up.

How It Works

1. onExtensionLoaded creates 11 ExtensionProxyTester objects (ids 0–10).
2. An ExtensionProxy is created and given the instances.
3. Every frame, each instance's onUpdate is called with the frame's dt values.
4. onExtensionUnloaded destroys the proxy.

Lua Examples

-- Load the test extension
extensions.load("util/testExtensionProxies")
-- Console will print 11 onUpdate messages per frame

-- The pattern for your own extension:
local proxy = newExtensionProxy(M)
proxy:submitEventSinks(myInstances)
-- Later:
proxy:destroy()

Additional Exports

• M.onExtensionLoaded - (undocumented)
• M.onExtensionUnloaded - (undocumented)