DOOM-3-BFG/neo/sys/sys_leaderboards.h

/*
===========================================================================

Doom 3 BFG Edition GPL Source Code
Copyright (C) 1993-2012 id Software LLC, a ZeniMax Media company. 

This file is part of the Doom 3 BFG Edition GPL Source Code ("Doom 3 BFG Edition Source Code").  

Doom 3 BFG Edition Source Code is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

Doom 3 BFG Edition Source Code is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with Doom 3 BFG Edition Source Code.  If not, see <http://www.gnu.org/licenses/>.

In addition, the Doom 3 BFG Edition Source Code is also subject to certain additional terms. You should have received a copy of these additional terms immediately following the terms and conditions of the GNU General Public License which accompanied the Doom 3 BFG Edition Source Code.  If not, please request a copy in writing from id Software at the address below.

If you have questions concerning this license or the applicable additional terms, you may contact in writing id Software LLC, c/o ZeniMax Media Inc., Suite 120, Rockville, Maryland 20850 USA.

===========================================================================
*/
#ifndef __SYS_LEADERBOARDS_H__
#define __SYS_LEADERBOARDS_H__


/*
================================================================================================

	Stats (for achievements, matchmaking, etc.)

================================================================================================
*/

/*
================================================
systemStats_t 
This is to give the framework the ability to deal with stat indexes that are
completely up to each game.  The system needs to deal with some stat indexes for things like
the level for matchmaking, etc.
================================================
*/

/*
================================================================================================

	Leaderboards

================================================================================================
*/

const int MAX_LEADERBOARDS			= 256;
const int MAX_LEADERBOARD_COLUMNS	= 16;

enum aggregationMethod_t {
	AGGREGATE_MIN,  // Write the new value if it is less than the existing value.
	AGGREGATE_MAX,  // Write the new value if it is greater than the existing value.
	AGGREGATE_SUM,  // Add the new value to the existing value and write the result.
	AGGREGATE_LAST, // Write the new value.
};

enum rankOrder_t {
	RANK_GREATEST_FIRST, // Rank the in descending order, greatest score is best score
	RANK_LEAST_FIRST,	 // Rank the in ascending order, lowest score is best score
};

enum statsColumnDisplayType_t {
	STATS_COLUMN_DISPLAY_NUMBER,
	STATS_COLUMN_DISPLAY_TIME_MILLISECONDS,
	STATS_COLUMN_DISPLAY_CASH,
	STATS_COLUMN_NEVER_DISPLAY,
};

struct columnDef_t {
	const char *				locDisplayName;
	int							bits;
	aggregationMethod_t			aggregationMethod;
	statsColumnDisplayType_t	displayType;
};

extern struct leaderboardDefinition_t * registeredLeaderboards[MAX_LEADERBOARDS];
extern int								numRegisteredLeaderboards;

struct leaderboardDefinition_t {
	leaderboardDefinition_t() :
		id ( -1 ),
		numColumns( 0 ),
		columnDefs( NULL ),
		rankOrder( RANK_GREATEST_FIRST ),
		supportsAttachments( false ),
		checkAgainstCurrent( false ) {
	}
	leaderboardDefinition_t( int id_, int numColumns_, const columnDef_t * columnDefs_, rankOrder_t rankOrder_, bool supportsAttachments_, bool checkAgainstCurrent_ ) :
		id ( id_ ),
		numColumns( numColumns_ ),
		columnDefs( columnDefs_ ),
		rankOrder( rankOrder_ ),
		supportsAttachments( supportsAttachments_ ),
		checkAgainstCurrent( checkAgainstCurrent_ ) {
		assert( numRegisteredLeaderboards < MAX_LEADERBOARDS );
		registeredLeaderboards[numRegisteredLeaderboards++] = this;
	}
	int32				id;
	int32				numColumns;
	const columnDef_t *	columnDefs;
	rankOrder_t			rankOrder;
	bool				supportsAttachments;
	bool				checkAgainstCurrent;		// Compare column 0 with the currently stored leaderboard, and only submit the new leaderboard if the new column 0 is better
};

struct column_t {
	column_t( int64 value_ ) : value( value_ ) {}
	column_t() {}

	int64				value;
};


/*
================================================================================================
Contains the Achievement and LeaderBoard free function declarations.
================================================================================================
*/

typedef int32			leaderboardHandle_t;

/*
================================================
idLeaderBoardEntry
================================================
*/
class idLeaderBoardEntry {
public:
	static const int MAX_LEADERBOARD_COLUMNS = 16;
	idStr username; // aka gamertag
	int64 score;
	int64 columns[ MAX_LEADERBOARD_COLUMNS ];
};

const leaderboardDefinition_t * Sys_FindLeaderboardDef( int id );


//------------------------
// leaderboardError_t
//------------------------
enum leaderboardError_t {
	LEADERBOARD_ERROR_NONE,
	LEADERBOARD_ERROR_FAILED,				// General error occurred
	LEADERBOARD_ERROR_NOT_ONLINE,			// Not online to request leaderboards
	LEADERBOARD_ERROR_BUSY,					// Unable to download leaderboards right now (download already in progress)
	LEADERBOARD_ERROR_INVALID_USER,			// Unable to request leaderboards as the given user
	LEADERBOARD_ERROR_INVALID_REQUEST,		// The leaderboard request was invalid
	LEADERBOARD_ERROR_DOWNLOAD,				// An error occurred while downloading the leaderboard
	LEADERBOARD_ERROR_MAX
};

/*
================================================
idLeaderboardCallback 
================================================
*/
class idLeaderboardCallback : public idCallback {
public:
	struct row_t {
		bool		hasAttachment;
		int64		attachmentID;
		idStr		name;
		int64		rank;
		idArray<int64,MAX_LEADERBOARD_COLUMNS> 	columns;

		long		user_id;
//		CSteamID	user_id;
	};

	idLeaderboardCallback() : def( NULL ), startIndex( -1 ), localIndex( -1 ), numRowsInLeaderboard( -1 ), errorCode( LEADERBOARD_ERROR_NONE ) { }
	virtual idLeaderboardCallback * Clone() const = 0;

	// Used by the platform handlers to set data
	void 							ResetRows() { rows.Clear(); }
	void 							AddRow( const row_t & row ) { rows.Append( row ); }
	void 							SetNumRowsInLeaderboard( int32 i ) { numRowsInLeaderboard = i; }
	void 							SetDef( const leaderboardDefinition_t * def_ ) { def = def_; }
	void 							SetStartIndex( int startIndex_ ) { startIndex = startIndex_; }
	void 							SetLocalIndex( int localIndex_ ) { localIndex = localIndex_; }
	void							SetErrorCode( leaderboardError_t errorCode ) { this->errorCode = errorCode; }

	// Used in user callback for information retrieval
	const leaderboardDefinition_t *	GetDef() const { return def; }
	int								GetStartIndex() const { return startIndex; }
	const idList< row_t > &			GetRows() const { return rows; } 
	int								GetNumRowsInLeaderboard() const { return numRowsInLeaderboard; }
	int								GetLocalIndex() const { return localIndex; }
	leaderboardError_t				GetErrorCode() const { return this->errorCode; }

protected:
	const leaderboardDefinition_t *	def;					// leaderboard def
	int								startIndex;				// where the first row starts in the online leaderboard
	int								localIndex;				// if player is in the rows, this is the offset of him within the returned rows
	idList< row_t >					rows;					// leaderboard entries for the request
	int								numRowsInLeaderboard;	// total number of rows in the online leaderboard
	leaderboardError_t				errorCode;				// error, if any, that occurred during last operation
};

#endif // !__SYS_LEADERBOARDS_H__