The "vngen_log_add" Function

Syntax#

vngen_log_add(index, data, [name], [font, col1, col2, col3, col4, shadow, outline, halign, lineheight]);

Argument	Type	Description
`index`	integer/macro	The numeric ID of the event being logged (labels not accepted) (or use 'auto' to add to system queue)
`data`	string/sound	The text or audio data to be added to the backlog
`[name]`	string	Optional: The speaking character name associated with the text
`[font]`	font	Optional: The original font of the logged text
`[col1]`	color	Optional: The original top-left gradient color of the text
`[col2]`	color	Optional: The original top-right gradient color of the text
`[col3]`	color	Optional: The original bottom-right gradient color of the text
`[col4]`	color	Optional: The original bottom-left gradient color of the text
`[shadow]`	color/macro	Optional: The original shadow color of the text (or keyword 'none' for none)
`[outline]`	color/macro	Optional: The original outline color of the text (or keyword 'none' for none)
`[halign]`	keyword	_Optional: _The paragraph alignment of the text (`fa_left`, `fa_center`, `fa_right`)
`[lineheight]`	real	_Optional: _The vertical separation between lines of text, as a multiplier

note

Text style properties are treated as a group. While including them is optional, they must either be included together or not at all.

Description#

Adds a new entry to the backlog at the specified event index. Input data can be either text or audio. If existing backlog data is found for the target event, the new data will be merged in as a single entry.

Data can also be added to the system queue for backlogged events by supplying the 'auto' keyword instead of a numerical event index. In this case, data will not be applied to the backlog immediately, but will automatically apply to the latest entry into the backlog when the current event is completed.

This script is triggered automatically by text, option, and voice functions and typically does not need to be run manually.

Example#

vngen_log_add(5, "John Doe: Hello, world!");
vngen_log_add(5, snd_hello);
vngen_log_add(auto, "Hello, world!", "John Doe", fnt_Arial, c_white, c_white, c_gray, c_gray, c_black, c_black, fa_left, 1.5);