# LV2 Log Extension # Copyright 2012 David Robillard # # Permission to use, copy, modify, and/or distribute this software for any # purpose with or without fee is hereby granted, provided that the above # copyright notice and this permission notice appear in all copies. # # THIS SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES # WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF # MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR # ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES # WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF # OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. @prefix doap: . @prefix foaf: . @prefix log: . @prefix lv2: . @prefix rdf: . @prefix rdfs: . @prefix xsd: . a lv2:Specification ; rdfs:seeAlso , <../../people/people.ttl> ; doap:name "LV2 Log" ; doap:shortdesc "A feature for writing log messages." ; doap:developer ; lv2:documentation """

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. Thus, the possible number of log levels is unlimited, but implementations SHOULD use the levels defined in this extension unless they have a special reason to do otherwise.

""" . log:Entry a rdfs:Class ; lv2:documentation """

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

""" . log:Error a rdfs:Class ; rdfs:subClassOf log:Entry ; rdfs:comment "An error" . log:Note a rdfs:Class ; rdfs:subClassOf log:Entry ; rdfs:comment "An informative message" . log:Warning a rdfs:Class ; rdfs:subClassOf log:Entry ; rdfs:comment "A warning" . log:Trace a rdfs:Class ; rdfs:subClassOf log:Entry ; lv2:documentation """

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.

""" . log:log a lv2:Feature ; lv2:documentation """

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.

""" .