OnDebugMessage - Revision history

Srslyyyy: Remove new item highlight.

2024-06-08T07:06:07Z

Remove new item highlight.

← Older revision		Revision as of 07:06, 8 June 2024
Line 6:		Line 6:

	==Parameters==		==Parameters==
	~~<syntaxhighlight lang="lua">~~
	~~string message, int level, string file, int line~~
	~~</syntaxhighlight>~~

	~~{{New items\|5.0154\|1.5.4-9.11412\|~~
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	string message, int level, string file, int line, int r, int g, int b		string message, int level, string file, int line, int r, int g, int b
	</syntaxhighlight>		</syntaxhighlight>
	}}

	*'''message''': the message which was outputted in the server console, without details like file, line etc.		*'''message''': the message which was outputted in the server console, without details like file, line etc.
Line 26:		Line 20:
	*'''line''': the line in file '''file''' where the debug message was outputted.		*'''line''': the line in file '''file''' where the debug message was outputted.
	**'''Note:''' may return [[nil]] when the source could not be found.		**'''Note:''' may return [[nil]] when the source could not be found.
	~~{{New items\|5.0154\|1.5.4-9.11412\|~~
	*'''r''': an [[int]] representing the amount of red color (0-255).		*'''r''': an [[int]] representing the amount of red color (0-255).
	*'''g''': an [[int]] representing the amount of green color (0-255).		*'''g''': an [[int]] representing the amount of green color (0-255).
	*'''b''': an [[int]] representing the amount of blue color (0-255).		*'''b''': an [[int]] representing the amount of blue color (0-255).
	}}

	==Source==		==Source==

Srslyyyy: Improve example.

2024-06-08T07:04:25Z

Improve example.

← Older revision		Revision as of 07:04, 8 June 2024
Line 39:		Line 39:

	==Example==		==Example==
	This example outputs ~~all~~ debug messages to ~~the~~ chat ~~box with the same colouring~~.		This example outputs error debug messages to chat.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	~~addEventHandler~~(~~"onDebugMessage"~~, ~~getRootElement~~(),		function onDebugMessage(debugMessage, debugLevel, debugFile, debugLine, debugRed, debugGreen, debugBlue)
			local debugError = (debugLevel == 1)

	~~function~~(~~message, level, file, line~~)		if (not debugError) then
			return false
			end

	~~if level~~ =~~= 1 then~~		local debugAtFile = (debugFile and debugFile or "NO_FILE")
	~~outputChatBox~~("~~ERROR:~~ " ~~.. file .. ":" .. tostring~~(~~line) ..~~ ", " ~~.. message, getRootElement(), 255,0,0~~)		local debugAtLine = (debugLine and debugLine or "NO_LINE")
	~~elseif level~~ =~~= 2 then~~		local debugChatMessage = "ERROR: "..debugAtFile..":"..debugAtLine..": "..debugMessage
	~~outputChatBox(~~"~~WARNING~~: " .. ~~file~~ .. ":" .. ~~tostring(line)~~ .. ", " .. ~~message, getRootElement(), 255,165,0)~~
	~~else~~		outputChatBox(debugChatMessage, root, debugRed, debugGreen, debugBlue)
	outputChatBox(~~"INFO: " .. file .. ":" .. tostring(line) .. "~~, ~~" .. message, getRootElement()~~, 0,0,~~255~~)
	end		end
			addEventHandler("onDebugMessage", root, onDebugMessage)

	~~end~~)
	</syntaxhighlight>		</syntaxhighlight>

	{{See also/Server event\|Server events}}		{{See also/Server event\|Server events}}

Srslyyyy: Add information about cancelling.

2024-06-08T06:53:24Z

Add information about cancelling.

← Older revision		Revision as of 06:53, 8 June 2024
Line 34:		Line 34:
	==Source==		==Source==
	The [[event system#Event source\|source]] of this event is the [[root element]].		The [[event system#Event source\|source]] of this event is the [[root element]].

			==Canceling==
			If this event is [[Event system #Canceling\|canceled]], the debug message won't appear.

	==Example==		==Example==

Botder at 21:19, 9 October 2018

2018-10-09T21:19:22Z

← Older revision		Revision as of 21:19, 9 October 2018
Line 3:		Line 3:
	This event is triggered when debug messages (for instance errors or warnings) appear in the server console.		This event is triggered when debug messages (for instance errors or warnings) appear in the server console.

	'''Note:''' To prevent infinite loops, debug messages that occur inside the function that handles this event won't ~~show up~~ so you won't be able to rely on debug info to fix ~~bad~~ code that is inside this function.		'''Note:''' To prevent infinite loops, debug messages that occur inside the function that handles this event won't trigger this event, so you won't be able to rely on debug info to fix faulty code that is inside this function. Since build [https://buildinfo.mtasa.com/index.php?Revision=14683 r14683] debug messages from [[outputDebugString]] and [[iprint]] will show up.

	==Parameters==		==Parameters==

Arran Fortuna: Added warning note about debug info not showing up inside this event.

2018-10-07T17:50:40Z

Added warning note about debug info not showing up inside this event.

← Older revision		Revision as of 17:50, 7 October 2018
Line 2:		Line 2:
	{{Server event}}		{{Server event}}
	This event is triggered when debug messages (for instance errors or warnings) appear in the server console.		This event is triggered when debug messages (for instance errors or warnings) appear in the server console.

			'''Note:''' To prevent infinite loops, debug messages that occur inside the function that handles this event won't show up so you won't be able to rely on debug info to fix bad code that is inside this function.

	==Parameters==		==Parameters==

Botder at 03:05, 27 September 2018

2018-09-27T03:05:05Z

← Older revision		Revision as of 03:05, 27 September 2018
Line 52:		Line 52:
	</syntaxhighlight>		</syntaxhighlight>

	==See ~~Also==~~		{{See also/Server event\|Server events}}
	~~===~~Server events~~===~~
	~~{{Server_events}}~~
	~~===Event functions===~~
	~~{{Event functions~~}}

Botder at 02:21, 27 September 2018

2018-09-27T02:21:53Z

← Older revision		Revision as of 02:21, 27 September 2018
Line 52:		Line 52:
	</syntaxhighlight>		</syntaxhighlight>

	{{See ~~also/Server event\|~~Server events}}		==See Also==
			===Server events===
			{{Server_events}}
			===Event functions===
			{{Event functions}}

Myonlake: /* Parameters */

2018-04-02T22:11:43Z

Parameters

← Older revision		Revision as of 22:11, 2 April 2018
Line 14:		Line 14:
	}}		}}

	*'''message''': ~~The~~ message which was outputted in the server console, without details like file, line etc		*'''message''': the message which was outputted in the server console, without details like file, line etc.
	*'''level''': ~~The~~ type of debug message which was outputted		*'''level''': the type of debug message which was outputted.
	**'''0:''' "Custom" message		**'''0:''' ''"Custom"'' message.
	**'''1:''' Error message		**'''1:''' ''Error'' message.
	**'''2:''' Warning message		**'''2:''' ''Warning'' message.
	**'''3:''' Information message		**'''3:''' ''Information'' message.
	*'''file''': ~~The~~ file from which the debug message was outputted		*'''file''': the file from which the debug message was outputted.
	**'''Note:''' ~~May~~ return [[nil]] when the source could not be found		**'''Note:''' may return [[nil]] when the source could not be found.
	*'''line''': ~~The~~ line in file '''file''' where the debug message was outputted		*'''line''': the line in file '''file''' where the debug message was outputted.
	**'''Note:''' ~~May~~ return [[nil]] when the source could not be found		**'''Note:''' may return [[nil]] when the source could not be found.
	{{New items\|5.0154\|1.5.4-9.11412\|		{{New items\|5.0154\|1.5.4-9.11412\|
	*'''r''': ~~Amount~~ of red color (0-255)		*'''r''': an [[int]] representing the amount of red color (0-255).
	*'''g''': ~~Amount~~ of green color (0-255)		*'''g''': an [[int]] representing the amount of green color (0-255).
	*'''b''': ~~Amount~~ of blue color (0-255)		*'''b''': an [[int]] representing the amount of blue color (0-255).
	}}		}}

Necktrox: Added RGB params

2017-06-02T16:05:37Z

Added RGB params

← Older revision		Revision as of 16:05, 2 June 2017
Line 6:		Line 6:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	string message, int level, string file, int line		string message, int level, string file, int line
	</syntaxhighlight>		</syntaxhighlight>

			{{New items\|5.0154\|1.5.4-9.11412\|
			<syntaxhighlight lang="lua">
			string message, int level, string file, int line, int r, int g, int b
			</syntaxhighlight>
			}}

	*'''message''': The message which was outputted in the server console, without details like file, line etc		*'''message''': The message which was outputted in the server console, without details like file, line etc
Line 18:		Line 24:
	*'''line''': The line in file '''file''' where the debug message was outputted		*'''line''': The line in file '''file''' where the debug message was outputted
	**'''Note:''' May return [[nil]] when the source could not be found		**'''Note:''' May return [[nil]] when the source could not be found
			{{New items\|5.0154\|1.5.4-9.11412\|
			*'''r''': Amount of red color (0-255)
			*'''g''': Amount of green color (0-255)
			*'''b''': Amount of blue color (0-255)
			}}

	==Source==		==Source==

Miki785: Added example

2012-02-28T18:55:20Z

Added example

@@ Line 23: / Line 23: @@
 ==Example==
 <syntaxhighlight lang="lua">
--- TODO
+addEventHandler("onDebugMessage", getRootElement(),
 </syntaxhighlight>
 {{See also/Server event|Server events}}