Engine.OnlineStatsWrite

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

/**
 * Stats class that accumulates the stats data before submitting it to the
 * online subsytem for storage.
 */
class OnlineStatsWrite extends OnlineStats
	native
	abstract;

/** Maps the stat's column num to the human readable stat name */
var const array<StringIdToStringMapping> StatMappings;

/** The array of properties to publish to the stats view */
var const array<SettingsProperty> Properties;

/** This array contains the list of views to write the properties to */
var const array<int> ViewIds;

/** This array contains the list of views to write the properties to for arbitrated matches */
var const array<int> ArbitratedViewIds;

/** This is the property id that is used to rate on */
var const int RatingId;

/**
 * Delegate used to notify the caller when stats write has completed
 */
delegate OnStatsWriteComplete();

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

/**
 * Searches the stat mappings to find the stat id that matches the name
 *
 * @param StatName the name of the stat being searched for
 * @param StatId the out value that gets the id
 *
 * @return true if it was found, false otherwise
 */
native function bool GetStatId(name StatName,out int StatId);

/**
 * Searches the stat mappings to find human readable name for the stat id
 *
 * @param StatId the id of the stats to find the name for
 *
 * @return true if it was found, false otherwise
 */
native function name GetStatName(int StatId);

/**
 * Sets a stat of type SDT_Float to the value specified. Does nothing
 * if the stat is not of the right type.
 *
 * @param StatId the stat to change the value of
 * @param Value the new value to assign to the stat
 */
native function SetFloatStat(int StatId,float Value);

/**
 * Sets a stat of type SDT_Int to the value specified. Does nothing
 * if the stat is not of the right type.
 *
 * @param StatId the stat to change the value of
 * @param Value the new value to assign to the stat
 */
native function SetIntStat(int StatId,int Value);

/**
 * Increments a stat of type SDT_Float by the value specified. Does nothing
 * if the stat is not of the right type.
 *
 * @param StatId the stat to increment
 * @param IncBy the value to increment by
 */
native function IncrementFloatStat(int StatId,optional float IncBy = 1.0);

/**
 * Increments a stat of type SDT_Int by the value specified. Does nothing
 * if the stat is not of the right type.
 *
 * @param StatId the stat to increment
 * @param IncBy the value to increment by
 */
native function IncrementIntStat(int StatId,optional int IncBy = 1);

/**
 * Decrements a stat of type SDT_Float by the value specified. Does nothing
 * if the stat is not of the right type.
 *
 * @param StatId the stat to decrement
 * @param DecBy the value to decrement by
 */
native function DecrementFloatStat(int StatId,optional float DecBy = 1.0);

/**
 * Decrements a stat of type SDT_Int by the value specified. Does nothing
 * if the stat is not of the right type.
 *
 * @param StatId the stat to decrement
 * @param DecBy the value to decrement by
 */
native function DecrementIntStat(int StatId,optional int DecBy = 1);

defaultproperties
{
   Name="Default__OnlineStatsWrite"
   ObjectArchetype=OnlineStats'Engine.Default__OnlineStats'
}