app_hooks.cpp File Reference

#include "precompiled.h"
#include "lib/app_hooks.h"
#include "lib/sysdep/sysdep.h"
#include <cstdio>

Include dependency graph for app_hooks.cpp:

Macros
#define	OVERRIDE_IF_NONZERO(HOOKNAME)   if(new_ah->HOOKNAME) ah.HOOKNAME = new_ah->HOOKNAME;

Functions
static void	def_override_gl_upload_caps ()
static const OsPath &	def_get_log_dir ()
static void	def_bundle_logs (FILE *f)
static const wchar_t *	def_translate (const wchar_t *text)
static void	def_translate_free (const wchar_t *text)
static void	def_log (const wchar_t *text)
static ErrorReactionInternal	def_display_error (const wchar_t *text, size_t flags)
void	app_hooks_update (AppHooks *new_ah)
	update the app hook function pointers. More...
bool	app_hook_was_redefined (size_t offset_in_struct)
	was the app hook changed via app_hooks_update from its default value? More...
void	ah_override_gl_upload_caps ()
	override default decision on using OpenGL extensions relating to texture upload. More...
const OsPath &	ah_get_log_dir ()
	return path to directory into which crash dumps should be written. More...
void	ah_bundle_logs (FILE *f)
	gather all app-related logs/information and write it to file. More...
const wchar_t *	ah_translate (const wchar_t *text)
	translate text to the current locale. More...
void	ah_translate_free (const wchar_t *text)
	free text that was returned by translate. More...
void	ah_log (const wchar_t *text)
	write text to the app's log. More...
ErrorReactionInternal	ah_display_error (const wchar_t *text, size_t flags)
	display an error dialog, thus overriding sys_display_error. More...

Variables
static AppHooks	ah
static AppHooks	default_ah = ah

Macro Definition Documentation

#define OVERRIDE_IF_NONZERO

(

HOOKNAME

)

if(new_ah->HOOKNAME) ah.HOOKNAME = new_ah->HOOKNAME;

Function Documentation

void ah_bundle_logs

(

FILE *

f

)

gather all app-related logs/information and write it to file.

used when writing a crash log so that all relevant info is in one file.

the default implementation attempts to gather 0ad data, but is fail-safe (doesn't complain if file not found).

Parameters

f	file into which to write.

ErrorReactionInternal ah_display_error	(	const wchar_t *	text,
		size_t	flags
	)

display an error dialog, thus overriding sys_display_error.

Parameters

text	error message.
flags	see DebugDisplayErrorFlags.

Returns

ErrorReactionInternal.

the default implementation just returns ERI_NOT_IMPLEMENTED, which causes the normal sys_display_error to be used.

const OsPath& ah_get_log_dir

(

)

return path to directory into which crash dumps should be written.

must be callable at any time - in particular, before VFS init. paths are typically relative to sys_ExecutablePathname.

Returns

path ending with directory separator (e.g. '/').

void ah_log

(

const wchar_t *

text

)

write text to the app's log.

Parameters

text

to write.

the default implementation uses stdout.

void ah_override_gl_upload_caps

(

)

override default decision on using OpenGL extensions relating to texture upload.

this should call ogl_tex_override to disable/force their use if the current card/driver combo respectively crashes or supports it even though the extension isn't advertised.

the default implementation works but is hardwired in code and therefore not expandable.

const wchar_t* ah_translate

(

const wchar_t *

text

)

translate text to the current locale.

Parameters

text	to translate.

Returns

pointer to localized text; must be freed via translate_free.

the default implementation just returns the pointer unchanged.

void ah_translate_free

(

const wchar_t *

text

)

free text that was returned by translate.

Parameters

text

to free.

the default implementation does nothing.

bool app_hook_was_redefined

(

size_t

offset_in_struct

)

was the app hook changed via app_hooks_update from its default value?

Parameters

offset_in_struct

byte offset within AppHooks (determined via offsetof) of the app hook function pointer.

void app_hooks_update

(

AppHooks *

ah

)

update the app hook function pointers.

Parameters

ah	AppHooks struct. any of its function pointers that are non-zero override the previous function pointer value (these default to the stub hooks which are functional but basic).

static void def_bundle_logs ( FILE *  f )

static

static ErrorReactionInternal def_display_error ( const wchar_t *  text, size_t  flags  )

static

static const OsPath& def_get_log_dir ( )

static

static void def_log ( const wchar_t *  text )

static

static void def_override_gl_upload_caps ( )

static

static const wchar_t* def_translate ( const wchar_t *  text )

static

static void def_translate_free ( const wchar_t *  text )

static

Variable Documentation

AppHooks ah

static

Initial value:

=
{
    def_override_gl_upload_caps,
    def_get_log_dir,
    def_bundle_logs,
    def_translate,
    def_translate_free,
    def_log,
    def_display_error
}

AppHooks default_ah = ah

static