cohtml::Logging

Classes

	Name
class	cohtml::Logging::ILogHandler Interface to allow custom logging.
struct	cohtml::Logging::LoggingSettings Controls filtering of categorized log messages. Used during library initialization to specify which TargetUser and MessageType categories should be emitted by the logger. By default all categories are enabled and MinimumSeverity is Info.
struct	cohtml::Logging::LogInfo Describes the metadata associated with a log message.

Types

	Name
enum class unsigned	TargetUser { None = 0, Internal = 1 << 0, Content = 1 << 1, Integration = 1 << 2, All = Internal
enum class unsigned	MessageType { None = 0, General = 1 << 0, Internal = 1 << 1, Rendering = 1 << 2, PerformanceHint = 1 << 3, UsageHint = 1 << 4, Compatibility = 1 << 5, Deprecation = 1 << 6, ScriptOutput = 1 << 7, Binding = 1 << 8, All = General
enum	Severity { Trace = 0, Debug = 1, Info = 2, Warning = 3, Error = 4, AssertFailure = 5, Critical = 5, SeveritiesCount = 6}

Functions

	Name
	COHTML_DEFINE_ENUM_FLAG_OPERATORS(cohtml::Logging::TargetUser )
	COHTML_DEFINE_ENUM_FLAG_OPERATORS(cohtml::Logging::MessageType )

Types Documentation

enum TargetUser

Enumerator	Value	Description
None	0	No audiences enabled. Suppresses all log output when used as EnabledTargetUsers.
Internal	1 << 0	Intended for developers of the Cohtml & Renoir libraries, mainly useful for debugging.
Content	1 << 1	Diagnostics intended for authors of HTML/CSS/JS UI content.
Integration	1 << 2	Diagnostics intended for engine developers responsible for integrating Cohtml.
All	Internal	Content

Identifies the primary audience for a diagnostic Values can be combined as bit flags to filter logs for multiple audiences in LoggingSettings - EnabledTargetUsers.

enum MessageType

Enumerator	Value	Description
None	0	No message categories enabled. Suppresses all log output when used as EnabledMessageTypes.
General	1 << 0	General-purpose diagnostic with no specific category.
Internal	1 << 1	Diagnostic category for internal development and troubleshooting.
Rendering	1 << 2	Diagnostic related to rendering-specific behavior or the Renoir rendering library.
PerformanceHint	1 << 3	Advisory diagnostic related to performance or memory cost.
UsageHint	1 << 4	Advisory diagnostic about recommended or correct usage.
Compatibility	1 << 5	Diagnostic related to platform, specification, or feature support differences.
Deprecation	1 << 6	Diagnostic indicating use of deprecated functionality.
ScriptOutput	1 << 7	Output from JavaScript console methods (console.log, console.warn, etc.)
Binding	1 << 8	Diagnostics related to the binding/data-binding features of Cohtml.
All	General	Internal

Describes the kind of diagnostic independently of severity and audience Values can be combined as bit flags to filter logs for multiple diagnostic categories in LoggingSettings - EnabledMessageTypes.

enum Severity

Enumerator	Value	Description
Trace	0
Debug	1
Info	2
Warning	3
Error	4
AssertFailure	5
Critical	5
SeveritiesCount	6

Functions Documentation

function COHTML_DEFINE_ENUM_FLAG_OPERATORS

COHTML_DEFINE_ENUM_FLAG_OPERATORS(
    cohtml::Logging::TargetUser
)

function COHTML_DEFINE_ENUM_FLAG_OPERATORS

COHTML_DEFINE_ENUM_FLAG_OPERATORS(
    cohtml::Logging::MessageType
)

---