Installing

Magic Cap objects can be installed into other objects via the installation list in an instance definition file. The objects that receives objects to be installed are known as install receivers, or simply receivers. Most Magic Cap objects that can be install receivers are referenced by indexicals. The user can move install objects to another location, causing entries in installation lists to be changed, created or removed entirely. These new locations may not have a corresponding indexical, or it may not be possible to easily describe them as receivers. Receivers that need more information to identify them normally inherit from the mixin class InstallReceiverProxy and override InstallInto. Magic Cap will place subclasses of InstallReceiverProxy into installation lists so that install objects can be re-installed into the correct place when the package containing the install object is re-integrated into Magic Cap. Receivers can mix in with CanOfferInstallReceiver to get the chance to return an InstallReceiverProxy subclass when Magic Cap needs to update install list entries. If your class inherits from CanOfferInstallReceiver, Magic Cap will call OfferInstallReceiver() to get an instance of an InstallReceiverProxy subclass.

Classes affected by these changes