Gst.LogContext

Fields

None

Methods

	free ()
	reset ()

Details

class Gst.LogContext

A context for controlling logging behavior, for example to handle logging once or periodic logging, avoiding to spam the terminal with the same log message multiple times.

Simple log context using static macros

``` c // At global/file scope: GST_LOG_CONTEXT_STATIC_DEFINE(my_context, Gst.LogContextFlags.THROTTLE, ); #define MY_CONTEXT GST_LOG_CONTEXT_LAZY_INIT(my_context)

// Then in code: GST_CTX_INFO(MY_CONTEXT, “This will only appear once per file/line”); ```

Periodic logging

For messages that should be logged periodically (e.g., maximum once per minute):

``` c // At global/file scope: GST_LOG_CONTEXT_STATIC_DEFINE(my_periodic_context, Gst.LogContextFlags.THROTTLE, GST_LOG_CONTEXT_BUILDER_SET_INTERVAL(60 * Gst.SECOND); ); #define MY_PERIODIC_CONTEXT GST_LOG_CONTEXT_LAZY_INIT(my_periodic_context)

// Then in code: GST_CTX_INFO(MY_PERIODIC_CONTEXT, “This appears once per minute”); ```

Customizing Message hash with custom flags and category

By default, a message’s hash is determined by the file name, object pointer, and format string. You can customize this with builder operations:

``` c // Ignore the object pointer when determining message hash (with throttling) GST_LOG_CONTEXT_STATIC_DEFINE(obj_independent_ctx, Gst.LogContextFlags.THROTTLE, GST_LOG_CONTEXT_BUILDER_SET_HASH_FLAGS(Gst.LogContextHashFlags.IGNORE_OBJECT); );

// Use a custom category (without throttling) GST_LOG_CONTEXT_STATIC_DEFINE(custom_cat_ctx, Gst.LogContextFlags.NONE, GST_LOG_CONTEXT_BUILDER_SET_CATEGORY(my_category); ); ```

New in version 1.28.

free()

Free the logging context, clearing all tracked messages.

New in version 1.28.

reset()

Resets the logging context, clearing all tracked messages.

New in version 1.28.