Header file for messageoptions related stuff. More...

#include "cp_messages.h"

Include dependency graph for cp_messageoptions.h:

This graph shows which files directly or indirectly include this file:

Data Structures
struct	messageSettings_t
	structure holding pause and notify settings for a notify type. More...
struct	msgCategoryEntry_t
struct	msgCategory_t

Macros
#define	MSO_PAUSE (NTMASK_PAUSE \| NTMASK_NOTIFY)
	notification type: pause game
#define	MSO_NOTIFY (NTMASK_NOTIFY)
	notification type: add notification message
#define	MSO_SOUND (NTMASK_SOUND \| NTMASK_NOTIFY)
	notification type: play notification sound
#define	MAX_MESSAGECATEGORIES 16

Enumerations
enum	notify_t { NT_INSTALLATION_INSTALLED , NT_INSTALLATION_REMOVED , NT_INSTALLATION_REPLACE , NT_AIRCRAFT_REFUELED , NT_AIRCRAFT_CANNOTREFUEL , NT_AIRCRAFT_ARRIVEDHOME , NT_INSTALLATION_BUILDSTART , NT_INSTALLATION_BUILDFINISH , NT_INSTALLATION_DESTROY , NT_RESEARCH_PROPOSED , NT_RESEARCH_HALTED , NT_RESEARCH_COMPLETED , NT_PRODUCTION_STARTED , NT_PRODUCTION_FINISHED , NT_PRODUCTION_FAILED , NT_PRODUCTION_QUEUE_EMPTY , NT_HAPPINESS_CHANGED , NT_HAPPINESS_MIN , NT_HAPPINESS_PLEASED , NT_TRANSFER_STARTED , NT_TRANSFER_COMPLETED_SUCCESS , NT_TRANSFER_LOST , NT_TRANSFER_ALIENBODIES_DEFERED , NT_TRANSFER_UFORECOVERY_FINISHED , NT_UFO_SPOTTED , NT_UFO_SIGNAL_LOST , NT_UFO_ATTACKING , NT_BASE_ATTACK , NT_BUILDING_FINISHED , NT_NUM_NOTIFYTYPE }
	Notify types. More...
enum	notifyMask_t { NTMASK_NOTIFY = 1 << 0 , NTMASK_PAUSE = 1 << 1 , NTMASK_SOUND = 1 << 2 }
	bitmask values for storing msgoptions More...
enum	msgCategoryMask_t { MSGCATMASK_FOLDED = 1 << 0 }
	bitmask values for storing msgcategory state More...

Functions
uiMessageListNodeMessage_t *	MSO_CheckAddNewMessage (const notify_t messagecategory, const char title, const char text, messageType_t type=MSG_STANDARD, technology_t *pedia=nullptr, bool popup=false)
	Adds a new message to message stack. It uses message settings to verify whether sound should be played and whether game should stop.
void	MSO_ParseMessageSettings (const char name, const char *text)
	parses message options settings from file.
void	MSO_Set (const int listIndex, const notify_t type, const int optionType, const bool activate, const bool sendCommands)
	Function updates pause or notification settings.
void	MSO_Init (void)
void	MSO_Shutdown (void)

Variables
messageSettings_t	messageSettings [NT_NUM_NOTIFYTYPE]
char const *const	nt_strings [NT_NUM_NOTIFYTYPE]
	valid notification types that may cause pause / notice

Detailed Description

Header file for messageoptions related stuff.

Definition in file cp_messageoptions.h.

Macro Definition Documentation

◆ MAX_MESSAGECATEGORIES

#define MAX_MESSAGECATEGORIES 16

Definition at line 92 of file cp_messageoptions.h.

Referenced by MSO_ParseCategory().

◆ MSO_NOTIFY

#define MSO_NOTIFY (NTMASK_NOTIFY)

notification type: add notification message

Definition at line 79 of file cp_messageoptions.h.

Referenced by MSO_LoadXML(), MSO_ParseOptionType(), MSO_Set(), and MSO_Toggle_f().

◆ MSO_PAUSE

#define MSO_PAUSE (NTMASK_PAUSE | NTMASK_NOTIFY)

notification type: pause game

Definition at line 77 of file cp_messageoptions.h.

Referenced by MSO_LoadXML(), MSO_ParseOptionType(), and MSO_Toggle_f().

◆ MSO_SOUND

#define MSO_SOUND (NTMASK_SOUND | NTMASK_NOTIFY)

notification type: play notification sound

Definition at line 81 of file cp_messageoptions.h.

Referenced by MSO_LoadXML(), MSO_ParseOptionType(), and MSO_Toggle_f().

Enumeration Type Documentation

◆ msgCategoryMask_t

enum msgCategoryMask_t

bitmask values for storing msgcategory state

Enumerator
MSGCATMASK_FOLDED

Definition at line 72 of file cp_messageoptions.h.

◆ notify_t

enum notify_t

Notify types.

Enumerator
NT_INSTALLATION_INSTALLED
NT_INSTALLATION_REMOVED
NT_INSTALLATION_REPLACE
NT_AIRCRAFT_REFUELED
NT_AIRCRAFT_CANNOTREFUEL
NT_AIRCRAFT_ARRIVEDHOME
NT_INSTALLATION_BUILDSTART
NT_INSTALLATION_BUILDFINISH
NT_INSTALLATION_DESTROY
NT_RESEARCH_PROPOSED
NT_RESEARCH_HALTED
NT_RESEARCH_COMPLETED
NT_PRODUCTION_STARTED
NT_PRODUCTION_FINISHED
NT_PRODUCTION_FAILED
NT_PRODUCTION_QUEUE_EMPTY
NT_HAPPINESS_CHANGED
NT_HAPPINESS_MIN
NT_HAPPINESS_PLEASED
NT_TRANSFER_STARTED
NT_TRANSFER_COMPLETED_SUCCESS
NT_TRANSFER_LOST
NT_TRANSFER_ALIENBODIES_DEFERED
NT_TRANSFER_UFORECOVERY_FINISHED
NT_UFO_SPOTTED
NT_UFO_SIGNAL_LOST
NT_UFO_ATTACKING
NT_BASE_ATTACK
NT_BUILDING_FINISHED
NT_NUM_NOTIFYTYPE

Definition at line 30 of file cp_messageoptions.h.

◆ notifyMask_t

enum notifyMask_t

bitmask values for storing msgoptions

Enumerator
NTMASK_NOTIFY
NTMASK_PAUSE
NTMASK_SOUND

Definition at line 65 of file cp_messageoptions.h.

Function Documentation

◆ MSO_CheckAddNewMessage()

uiMessageListNodeMessage_t * MSO_CheckAddNewMessage	(	const notify_t	messagecategory,
		const char *	title,
		const char *	text,
		messageType_t	type,
		technology_t *	pedia,
		bool	popup )

Adds a new message to message stack. It uses message settings to verify whether sound should be played and whether game should stop.

Parameters

	messagecategory	category for notification
[in]	title	Already translated message/mail title
[in]	text	Already translated message/mail body
[in]	popup	Show this as a popup, too?
[in]	type	The message type
[in]	pedia	Pointer to technology (only if needed)

Returns: message_t pointer if message was added

See also: MS_AddNewMessageSound

Definition at line 208 of file cp_messageoptions.cpp.

References CP_GameTimeStop(), messageSettings_t::doNotify, messageSettings_t::doPause, messageSettings_t::doSound, messageSettings, MS_AddNewMessage(), and type.

Referenced by AII_UpdateOneInstallationDelay(), AIR_Move(), AIR_Refuel(), AIRFIGHT_ExecuteActions(), B_UpdateBuildingConstructions(), CP_BaseAttackStartMission(), INS_BuildInstallation_f(), INS_DestroyInstallation(), INS_UpdateInstallationData(), NAT_SetHappiness(), PR_CheckFrame(), PR_FinishDisassembly(), PR_FinishProduction(), PR_ProductionIncrease_f(), PR_QueueNext(), RS_CheckRequirements(), RS_MarkCollected(), RS_MarkOneResearchable(), RS_ResearchFinish(), RS_ResearchRun(), TR_EmptyTransferCargo(), TR_TransferEnd(), TR_TransferStart_f(), UFO_CampaignCheckEvents(), UFO_SearchAircraftTarget(), UR_ProcessActive(), and US_TransferUFO().

◆ MSO_Init()

void MSO_Init ( void )

Definition at line 484 of file cp_messageoptions.cpp.

References cgi, msgOptionsCmds, and MSO_InitCallbacks().

Referenced by MS_MessageInit().

◆ MSO_ParseMessageSettings()

void MSO_ParseMessageSettings	(	const char *	name,
		const char **	text )

parses message options settings from file.

Definition at line 444 of file cp_messageoptions.cpp.

References cgi, Com_Parse(), ERR_DROP, messageSettings, MSO_ParseCategory(), name, OBJZERO, and Q_streq.

Referenced by CP_ParseScriptFirst().

◆ MSO_Set()

void MSO_Set	(	const int	listIndex,
		const notify_t	type,
		const int	optionType,
		const bool	activate,
		const bool	sendCommands )

Function updates pause or notification settings.

Parameters

listIndex	listIndex in menu to update via confunc
type	notification type to update
optionType	option type that should be updated
activate	flag indicating whether setting should be activated (true) or deactivated
sendCommands	flag indicating whether confunc command to update menu button should be sent