Description

This extension defines a feature, log:log, which allows plugins to print log messages with an API much like the standard C printf functions. This allows, for example, plugin logs to be nicely presented to the user in a graphical user interface.

Different log levels (e.g. error or information) are defined by URI and passed as an LV2_URID. This document defines the typical levels which should be sufficient, but implementations may define and use additional levels to suit their needs.

Index

Classes
Instances
log

Reference

Class log:Entry

A log entry. Subclasses of this class can be passed to LV2_Log_Log methods to describe the nature of the log message.

Class log:Error

An error

Sub-class oflog:Entry

Class log:Note

An informative message

Sub-class oflog:Entry

Class log:Trace

A debugging trace. These entries should not be displayed during normal operation, but the host may implement an option to display them for debugging purposes.

This entry type is special in that it may be written to in a real-time thread. It is assumed that if debug tracing is enabled, real-time considerations are not a concern.

Sub-class oflog:Entry

Class log:Warning

A warning

Sub-class oflog:Entry

Instance log:log

A feature which plugins may use to log messages. To support this feature, the host must pass an LV2_Feature to LV2_Descriptor::instantiate() with URI LV2_LOG__log and data pointed to an instance of LV2_Log_Log.

Typelv2:Feature

History

Version 1.12 (2014-08-08)
  • Minor documentation improvements.
Version 2.2 (2014-01-04)
  • Add missing include string.h to logger.h for memset.
Version 1.6 (2013-05-26)
  • Fix crash in forge.h when pushing atoms to a full buffer.
Version 1.4 (2013-01-27)
  • Fix lv2_atom_sequence_end().
  • Improve atom documentation.
  • Remove atom:stringType in favour of owl:onDatatype so generic tools can understand and validate atom literals.
Version 1.10 (2013-01-13)
  • Fix incorrect return type in lv2_event_get().
Version 2.0 (2013-01-08)
  • Add logger convenience API.
Version 1.2 (2012-12-21)
  • Fix typo in bufsz:sequenceSize label.
Version 1.8 (2012-10-14)
  • Make event iterator gracefully handle optional ports.
  • Use consistent label style.
  • Remove asserts from event-helper.h.
  • Use more precise domain and range for EventPort properties.
Version 1.0 (2012-04-17)
  • Initial release.
Version 1.4 (2011-11-21)
  • Update packaging.
  • Improve documentation.
Version 1.4 (2011-11-21)
  • Update packaging.
Version 1.4 (2011-11-21)
  • Improve documentation.
  • Update packaging.
Version 1.2 (2011-05-26)
  • Add build system for installation.
  • Switch to ISC license.
Version 1.2 (2011-05-26)
  • Use lv2:Specification to be discovered as an extension.
  • Convert documentation to HTML and use lv2:documentation.
  • Add build system (for installation).
Version 1.2 (2011-05-26)
  • Switch to ISC license.
  • Add build system for installation.
Version 1.0 (2010-11-24)
  • Initial release.
Version 1.0 (2010-10-04)
  • Initial release.
Version 1.0 (2010-10-04)
  • Initial release.