Achievements

Achievements, unlockables API reference. More...

Detailed Description

Achievements, unlockables API reference.

The Achievements API manages the retrieval, storage and networking of game achievements.

This is a work in progress.

Classes
struct	achievement_t
	Data for an achievement definition. More...

Functions
void	Achievement_Set (string strName)
	Unlock an achievement.
void	Achievement_Clear (string strName)
	Clear an achievement (development purposes mainly).
bool	Achievement_Get (string strName)
	Returns whether or not an achievement has been achieved.
string	Achievement_GetIcon (string strName)
	Get the icon of an achievement.
float	Achievement_GetPercentage (string strName)
	STUB, returns how many other users achieved this.
void	Achievement_IndicateProgress (string strName, int iCurrent, int iMax)
	Requests an overlay to be drawn.
bool	Achievement_RequestStats (achievement_t *ptr, int count)
	Updates the achievement_t pointer with what's been achieved and what's not been achieved from a remote location.

Function Documentation

Achievement_Clear()

void Achievement_Clear

(

string

strName

)

Clear an achievement (development purposes mainly).

Parameters

strName

The name identifier of the achivement.

Achievement_Get()

bool Achievement_Get

(

string

strName

)

Returns whether or not an achievement has been achieved.

Parameters

strName

The name identifier of the achivement.

Returns

true when achieved, false if not.

Achievement_GetIcon()

string Achievement_GetIcon

(

string

strName

)

Get the icon of an achievement.

Parameters

strName

The name identifier of the achivement.

Returns

The URL or local file pointing to an image or icon.

Achievement_GetPercentage()

float Achievement_GetPercentage

(

string

strName

)

STUB, returns how many other users achieved this.

Parameters

strName

The name identifier of the achivement.

Returns

Normalized value between 0.0 - 1.0 indicating progress.

Achievement_IndicateProgress()

void Achievement_IndicateProgress	(	string	strName,
		int	iCurrent,
		int	iMax )

Requests an overlay to be drawn.

It indicates the progression towards a particular achivement.

Parameters

strName	The name identifier of the achievement.
iCurrent	The current value of progress.
iMax	The maximum value of progress.

Achievement_RequestStats()

bool Achievement_RequestStats	(	achievement_t *	ptr,
		int	count )

Updates the achievement_t pointer with what's been achieved and what's not been achieved from a remote location.

Parameters

ptr	Pointer to an achievement_t array.
count	Local version of the achivement stat count.

Returns

Will return false upon failure.

Achievement_Set()

void Achievement_Set

(

string

strName

)

Unlock an achievement.

Parameters

strName

The name identifier of the achivement.