Engine.UIDataStore_OnlineGameSettings

/**
 * Copyright 1998-2008 Epic Games, Inc. All Rights Reserved.
 */

/**
 * This class is responsible for mapping properties in an OnlineGameSettings
 * object to something that the UI system can consume.
 *
 * NOTE: Each game needs to derive at least one class from this one in
 * order to expose the game's specific settings class(es)
 */
class UIDataStore_OnlineGameSettings extends UIDataStore_Settings
	native(inherit)
	abstract
	transient;

/** Holds the information used to expose 1 or more game settings providers */
struct native GameSettingsCfg
{
	/** The OnlineGameSettings derived class to create and expose */
	var class<OnlineGameSettings> GameSettingsClass;
	/** The provider that was created to process the specified game settings object */
	var UIDataProvider_Settings Provider;
	/** The object we are exposing to the UI */
	var OnlineGameSettings GameSettings;
	/** Used to set/select by name */
	var name SettingsName;
};

/** The list of settings that this data store is exposing */
var const array<GameSettingsCfg> GameSettingsCfgList;

/** The index into the list that is currently being exposed */
var int SelectedIndex;

// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)
// (cpptext)

/**
 * Called to kick create an online game based upon the settings
 *
 * @param WorldInfo the world info object. useful for actor iterators
 * @param ControllerIndex the ControllerId for the player to create the game for
 *
 * @return TRUE if the game was created, FALSE otherwise
 */
event bool CreateGame( byte ControllerIndex )
{
	local OnlineSubsystem OnlineSub;
	local OnlineGameInterface GameInterface;

	// Figure out if we have an online subsystem registered
	OnlineSub = class'GameEngine'.static.GetOnlineSubsystem();
	if (OnlineSub != None)
	{
		// Grab the game interface to verify the subsystem supports it
		GameInterface = OnlineSub.GameInterface;
		if (GameInterface != None)
		{
			// Start the async task
			return GameInterface.CreateOnlineGame(ControllerIndex,GameSettingsCfgList[SelectedIndex].GameSettings);
		}
		else
		{
			WarnInternal("OnlineSubsystem does not support the game interface. Can't create online games");
		}
	}
	else
	{
		WarnInternal("No OnlineSubsystem present. Can't create online games");
	}
	return false;
}

/** Returns the game settings object that is currently selected */
event OnlineGameSettings GetCurrentGameSettings()
{
	return GameSettingsCfgList[SelectedIndex].GameSettings;
}

// Stores the current game settings object values to the specified settings profile
function StoreCurrentSettings(string ProfileName)
{
	local OnlineGameSettings CurSettings;
	local SettingsProfile ProfileObj;

	CurSettings = GameSettingsCfgList[SelectedIndex].GameSettings;

	if (CurSettings == none)
		return;


	ProfileObj = new(none, string(GameSettingsCfgList[SelectedIndex].SettingsName)$"_"$ProfileName) Class'SettingsProfile';

	ProfileObj.SaveSettings(CurSettings);
}

// Loads values from the specified settings profile to the current game settings object
function LoadToCurrentSettings(string ProfileName)
{
	local OnlineGameSettings CurSettings;
	local SettingsProfile ProfileObj;

	CurSettings = GameSettingsCfgList[SelectedIndex].GameSettings;

	if (CurSettings == none)
		return;


	ProfileObj = new(none, string(GameSettingsCfgList[SelectedIndex].SettingsName)$"_"$ProfileName) Class'SettingsProfile';

	ProfileObj.TransferSettings(CurSettings);
}


/** Returns the provider object that is currently selected */
event UIDataProvider_Settings GetCurrentProvider()
{
	return GameSettingsCfgList[SelectedIndex].Provider;
}

/**
 * Sets the index into the list of game settings to use
 *
 * @param NewIndex the new index to use
 */
event SetCurrentByIndex(int NewIndex)
{
	// Range check to prevent accessed nones
	if (NewIndex > 0 && NewIndex < GameSettingsCfgList.Length)
	{
		SelectedIndex = NewIndex;
		// Notify any subscribers that we have new data
		NotifyPropertyChanged();
		// notify any subscribers that we have new data
		RefreshSubscribers( , true, GetCurrentProvider());
	}
	else
	{
		LogInternal("Invalid index ("$NewIndex$") specified to SetCurrentByIndex() on "$Self);
	}
}

/**
 * Sets the index into the list of game settings to use
 *
 * @param SettingsName the name of the setting to find
 */
event SetCurrentByName(name SettingsName)
{
	local int Index;

	for (Index = 0; Index < GameSettingsCfgList.Length; Index++)
	{
		// If this is the one we want, set it and refresh
		if (GameSettingsCfgList[Index].SettingsName == SettingsName)
		{
			SelectedIndex = Index;
			// Notify any subscribers that we have new data
			NotifyPropertyChanged();
			// notify any subscribers that we have new data
			RefreshSubscribers( , true, GetCurrentProvider());
			return;
		}
	}
	LogInternal("Invalid name ("$SettingsName$") specified to SetCurrentByName() on "$Self);
}

/** Moves to the next item in the list */
event MoveToNext()
{
	SelectedIndex = Min(SelectedIndex + 1,GameSettingsCfgList.Length - 1);
	// Notify any subscribers that we have new data
	NotifyPropertyChanged();
	// notify any subscribers that we have new data
	RefreshSubscribers( , true, GetCurrentProvider());
}

/** Moves to the previous item in the list */
event MoveToPrevious()
{
	SelectedIndex = Max(SelectedIndex - 1,0);
	// Notify any subscribers that we have new data
	NotifyPropertyChanged();
	// notify any subscribers that we have new data
	RefreshSubscribers( , true, GetCurrentProvider());
}

defaultproperties
{
   Tag="OnlineGameSettings"
   WriteAccessType=ACCESS_WriteAll
   Name="Default__UIDataStore_OnlineGameSettings"
   ObjectArchetype=UIDataStore_Settings'Engine.Default__UIDataStore_Settings'
}