Enum gstreamer::DebugLevel [−][src]
#[non_exhaustive] pub enum DebugLevel { None, Error, Warning, Fixme, Info, Debug, Log, Trace, Memdump, Count, // some variants omitted }
Expand description
The level defines the importance of a debugging message. The more important a message is, the greater the probability that the debugging system outputs it.
Variants (Non-exhaustive)
This enum is marked as non-exhaustive
No debugging level specified or desired. Used to deactivate debugging output.
Error messages are to be used only when an error occurred that stops the application from keeping working correctly. An examples is gst_element_error, which outputs a message with this priority. It does not mean that the application is terminating as with g_error.
Warning messages are to inform about abnormal behaviour that could lead to problems or weird behaviour later on. An example of this would be clocking issues (“your computer is pretty slow”) or broken input data (“Can’t synchronize to stream.”)
Fixme messages are messages that indicate that something in the executed code path is not fully implemented or handled yet. Note that this does not replace proper error handling in any way, the purpose of this message is to make it easier to spot incomplete/unfinished pieces of code when reading the debug log.
Informational messages should be used to keep the developer updated about what is happening. Examples where this should be used are when a typefind function has successfully determined the type of the stream or when an mp3 plugin detects the format to be used. (“This file has mono sound.”)
Debugging messages should be used when something common happens that is not the expected default behavior, or something that’s useful to know but doesn’t happen all the time (ie. per loop iteration or buffer processed or event handled). An example would be notifications about state changes or receiving/sending of events.
Log messages are messages that are very common but might be useful to know. As a rule of thumb a pipeline that is running as expected should never output anything else but LOG messages whilst processing data. Use this log level to log recurring information in chain functions and loop functions, for example.
Tracing-related messages. Examples for this are referencing/dereferencing of objects.
memory dump messages are used to log (small) chunks of data as memory dumps in the log. They will be displayed as hexdump with ASCII characters.
The number of defined debugging levels.
Implementations
Trait Implementations
type Checker = GenericValueTypeChecker<Self>
type Checker = GenericValueTypeChecker<Self>
Value type checker.
Get the contained value from a Value
. Read more
This method tests for self
and other
values to be equal, and is used
by ==
. Read more
This method tests for !=
.
This method returns an ordering between self
and other
values if one exists. Read more
This method tests less than (for self
and other
) and is used by the <
operator. Read more
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
Returns the type identifier of Self
.
Auto Trait Implementations
impl RefUnwindSafe for DebugLevel
impl Send for DebugLevel
impl Sync for DebugLevel
impl Unpin for DebugLevel
impl UnwindSafe for DebugLevel
Blanket Implementations
Mutably borrows from an owned value. Read more
Returns a SendValue
clone of self
.