using System; using System.Linq; using System.Reflection; namespace BizHawk.Emulation.Common { /// /// This service provides mechanism for the client to set sync and non-sync related settings to the core /// Settings are settings that can changge during the lifetime of the core and do not affect potential movie sync /// Sync Settings do not change during the lifetime of the core and affect movie sync /// If available, Sync settings are stored in movie files and automatically applied when the movie is loaded /// If this service is available the client can provide UI for the user to manage these settings /// /// The Type of the object that represent regular settings (settings that can be changed during the lifespan of a core instance /// The Type of the object that represents sync settings (settings that can not change during hte lifespan of the core and are required for movie sync public interface ISettable : IEmulatorService { // in addition to these methods, it's expected that the constructor or Load() method // will take a Settings and SyncSettings object to set the initial state of the core // (if those are null, default settings are to be used) /// /// get the current core settings, excepting movie settings. should be a clone of the active in-core object. /// VERY IMPORTANT: changes to the object returned by this function SHOULD NOT have any effect on emulation /// (unless the object is later passed to PutSettings) /// /// a json-serializable object TSettings GetSettings(); /// /// get the current core settings that affect movie sync. these go in movie 2.0 files, so don't make the JSON too extravagant, please /// should be a clone of the active in-core object. /// VERY IMPORTANT: changes to the object returned by this function MUST NOT have any effect on emulation /// (unless the object is later passed to PutSyncSettings) /// /// a json-serializable object TSync GetSyncSettings(); /// /// change the core settings, excepting movie settings /// /// an object of the same type as the return for GetSettings /// true if a core reboot will be required to make the changes effective bool PutSettings(TSettings o); /// /// changes the movie-sync relevant settings. THIS SHOULD NEVER BE CALLED WHILE RECORDING /// if it is called while recording, the core need not guarantee continued determinism /// /// an object of the same type as the return for GetSyncSettings /// true if a core reboot will be required to make the changes effective bool PutSyncSettings(TSync o); } /// /// serves as a shim between strongly typed ISettable and consumers /// public class SettingsAdapter { public SettingsAdapter(IEmulator e) { emu = e; Type impl = e.GetType().GetInterfaces() .Where(t => t.IsGenericType && t.GetGenericTypeDefinition() == typeof(ISettable<,>)).FirstOrDefault(); if (impl == null) { HasSettings = false; HasSyncSettings = false; } else { var tt = impl.GetGenericArguments(); settingtype = tt[0]; synctype = tt[1]; HasSettings = settingtype != typeof(object); // object is used for a placeholder where an emu doesn't have both s and ss HasSyncSettings = synctype != typeof(object); if (HasSettings) { gets = impl.GetMethod("GetSettings"); puts = impl.GetMethod("PutSettings"); } if (HasSyncSettings) { getss = impl.GetMethod("GetSyncSettings"); putss = impl.GetMethod("PutSyncSettings"); } } } private IEmulator emu; public bool HasSettings { get; private set; } public bool HasSyncSettings { get; private set; } private object[] tmp1 = new object[1]; private object[] tmp0 = new object[0]; private Type settingtype; private Type synctype; private MethodInfo gets; private MethodInfo puts; private MethodInfo getss; private MethodInfo putss; public object GetSettings() { if (!HasSettings) { throw new InvalidOperationException(); } return gets.Invoke(emu, tmp0); } public object GetSyncSettings() { if (!HasSyncSettings) { throw new InvalidOperationException(); } return (getss.Invoke(emu, tmp0)); } public bool PutSettings(object o) { if (!HasSettings) { throw new InvalidOperationException(); } tmp1[0] = o; return (bool)puts.Invoke(emu, tmp1); } public bool PutSyncSettings(object o) { if (!HasSyncSettings) { throw new InvalidOperationException(); } tmp1[0] = o; return (bool)putss.Invoke(emu, tmp1); } } }