AGS: Improve globals documentation

This commit is contained in:
Thierry Crozat 2021-05-21 19:52:03 +01:00
parent ac43a4318f
commit 6acd1ec59e
2 changed files with 157 additions and 72 deletions

View File

@ -44,4 +44,12 @@
@defgroup image Image API @defgroup image Image API
@brief API of various image decoders used in engines. @brief API of various image decoders used in engines.
*/ */
/**
@defgroup agsengine AGS Engine
@brief Engine to run Adventure Game Studio games.
*/

View File

@ -167,7 +167,14 @@ struct ViewStruct;
class Globals { class Globals {
public: public:
/** /**
* \defgroup Allegro globals * @defgroup agsglobals AGS Globals
* @ingroup agsengine
* @brief Globals for the AGS engine
*/
/**
* @defgroup agsallegroglobals Allegro globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -213,7 +220,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup agsplatformdriver globals * @defgroup agsplatformdriverglobals agsplatformdriver globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -225,7 +233,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup agsplugin globals * @defgroup agspluginglobals agsplugin globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -234,7 +243,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup agsstaticobject globals * @defgroup agsstaticobjectglobals agsstaticobject globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -244,7 +254,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup audio globals * @defgroup agsaudioglobals audio globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -273,7 +284,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup button globals * @defgroup agsbuttonglobals button globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -283,7 +295,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup cc_dynamicarray globals * @defgroup agscc_dynamicarrayglobals cc_dynamicarray globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -292,7 +305,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup cc_dynamicobject globals * @defgroup agscc_dynamicobjectglobals cc_dynamicobject globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -301,7 +315,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup cc_error globals * @defgroup agscc_errorglobals cc_error globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -315,7 +330,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup cc_instance globals * @defgroup agscc_instanceglobals cc_instance globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -330,7 +346,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup cc_options globals * @defgroup agscc_optionsglobals cc_options globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -339,7 +356,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup cc_script globals * @defgroup agscc_scriptglobals cc_script globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -351,7 +369,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup cc_serializer globals * @defgroup agscc_serializerglobals cc_serializer globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -360,7 +379,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup character globals * @defgroup agscharacterglobals character globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -371,7 +391,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup character globals * @defgroup agscharacterglobals character globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -399,7 +420,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup cscdialog globals * @defgroup agscscdialogglobals cscdialog globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -418,7 +440,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup debug globals * @defgroup agsdebugglobals debug globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -451,7 +474,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup debug globals * @defgroup agsdebugglobals debug globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -460,7 +484,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup dialog globals * @defgroup agsdialogglobals dialog globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -478,7 +503,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup display globals * @defgroup agsdisplayglobals display globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -495,7 +521,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup draw globals * @defgroup agsdrawglobals draw globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -534,7 +561,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup draw_software globals * @defgroup agsdraw_softwareglobals draw_software globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -551,7 +579,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup engine globals * @defgroup agsengineglobals engine globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -560,7 +589,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup engine globals * @defgroup agsengineglobals engine globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -570,7 +600,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup engine_setup globals * @defgroup agsengine_setupglobals engine_setup globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -580,7 +611,8 @@ public:
/** /**
* \defgroup event globals * @defgroup agseventglobals event globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -601,7 +633,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup file globals * @defgroup agsfileglobals file globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -617,7 +650,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup fonts globals * @defgroup agsfontsglobals fonts globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -629,7 +663,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup game globals * @defgroup agsgameglobals game globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -704,7 +739,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup game_init globals * @defgroup agsgame_initglobals game_init globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -719,7 +755,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup game_run globals * @defgroup agsgame_runglobals game_run globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -738,7 +775,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup gfxfilter_aad3d globals * @defgroup agsgfxfilter_aad3dglobals gfxfilter_aad3d globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -747,7 +785,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup gfxfilter_allegro globals * @defgroup agsgfxfilter_allegroglobals gfxfilter_allegro globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -756,7 +795,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup gfxfilter_allegro globals * @defgroup agsgfxfilter_allegroglobals gfxfilter_allegro globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -765,7 +805,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup gfxfilter_d3d globals * @defgroup agsgfxfilter_d3dglobals gfxfilter_d3d globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -774,7 +815,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup global_dialog globals * @defgroup agsglobal_dialogglobals global_dialog globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -783,7 +825,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup global_object globals * @defgroup agsglobal_objectglobals global_object globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -793,7 +836,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup graphics_mode globals * @defgroup agsgraphics_modeglobals graphics_mode globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -812,7 +856,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup gui globals * @defgroup agsguiglobals gui globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -824,7 +869,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup guibutton globals * @defgroup agsguibuttonglobals guibutton globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -834,7 +880,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup guidialog globals * @defgroup agsguidialogglobals guidialog globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -856,7 +903,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup guiinv globals * @defgroup agsguiinvglobals guiinv globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -866,7 +914,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup guilabel globals * @defgroup agsguilabelglobals guilabel globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -876,7 +925,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup guilistbox globals * @defgroup agsguilistboxglobals guilistbox globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -886,7 +936,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup guimain globals * @defgroup agsguimainglobals guimain globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -897,7 +948,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup guislider globals * @defgroup agsguisliderglobals guislider globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -907,7 +959,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup guitextbox globals * @defgroup agsguitextboxglobals guitextbox globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -917,7 +970,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup interactions globals * @defgroup agsinteractionsglobals interactions globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -927,7 +981,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup invwindow globals * @defgroup agsinvwindowglobals invwindow globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -936,7 +991,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup lzw globals * @defgroup agslzwglobals lzw globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -948,7 +1004,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup main globals * @defgroup agsmainglobals main globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -998,7 +1055,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup managedobjectpool globals * @defgroup agsmanagedobjectpoolglobals managedobjectpool globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1007,7 +1065,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup mouse globals * @defgroup agsmouseglobals mouse globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1033,7 +1092,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup mousew32 globals * @defgroup agsmousew32globals mousew32 globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1044,7 +1104,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup overlay globals * @defgroup agsoverlayglobals overlay globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1054,7 +1115,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup quit globals * @defgroup agsquitglobals quit globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1064,7 +1126,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup quit globals * @defgroup agsquitglobals quit globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1076,7 +1139,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup room globals * @defgroup agsroomglobals room globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1088,7 +1152,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup route_finder_impl globals * @defgroup agsroute_finder_implglobals route_finder_impl globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1102,7 +1167,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup screen globals * @defgroup agsscreenglobals screen globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1113,7 +1179,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup script globals * @defgroup agsscriptglobal script globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1158,7 +1225,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup script_runtime globals * @defgroup agsscript_runtimeglobals script_runtime globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1169,7 +1237,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup soundcache globals * @defgroup agssoundcacheglobals soundcache globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1179,7 +1248,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup string globals * @defgroup agsstringglobals string globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1188,7 +1258,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup systemimports globals * @defgroup agssystemimportsglobals systemimports globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1198,7 +1269,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup sys_events globals * @defgroup agssys_eventsglobals sys_events globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1208,7 +1280,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup timer globals * @defgroup agstimerglobals timer globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1221,7 +1294,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup translation globals * @defgroup agstranslationglobals translation globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1232,7 +1306,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup walkablearea globals * @defgroup agswalkableareaglobals walkablearea globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1241,7 +1316,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup walkbehind globals * @defgroup agswalkbehindglobals walkbehind globals
* @ingroup agsglobals
* @{ * @{
*/ */
@ -1258,7 +1334,8 @@ public:
/**@}*/ /**@}*/
/** /**
* \defgroup wordsdictionary globals * @defgroup agswordsdictionaryglobals wordsdictionary globals
* @ingroup agsglobals
* @{ * @{
*/ */