aboutsummaryrefslogtreecommitdiffstats
path: root/lv2/log.lv2
diff options
context:
space:
mode:
Diffstat (limited to 'lv2/log.lv2')
-rw-r--r--lv2/log.lv2/log.meta.ttl83
-rw-r--r--lv2/log.lv2/log.ttl47
-rw-r--r--lv2/log.lv2/manifest.ttl8
3 files changed, 138 insertions, 0 deletions
diff --git a/lv2/log.lv2/log.meta.ttl b/lv2/log.lv2/log.meta.ttl
new file mode 100644
index 0000000..0c74e6c
--- /dev/null
+++ b/lv2/log.lv2/log.meta.ttl
@@ -0,0 +1,83 @@
+@prefix doap: <http://usefulinc.com/ns/doap#> .
+@prefix foaf: <http://xmlns.com/foaf/0.1/> .
+@prefix log: <http://lv2plug.in/ns/ext/log#> .
+@prefix lv2: <http://lv2plug.in/ns/lv2core#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+
+<http://lv2plug.in/ns/ext/log>
+ a doap:Project ;
+ doap:name "LV2 Log" ;
+ doap:shortdesc "A feature for writing log messages." ;
+ doap:created "2012-01-12" ;
+ doap:developer <http://drobilla.net/drobilla#me> ;
+ lv2:documentation """
+
+This extension defines a feature, log:log, which allows plugins to print log
+messages with an API similar to the standard C `printf` function. This allows,
+for example, plugin logs to be nicely presented to the user in a graphical user
+interface.
+
+Different log levels are defined by URI and passed as an LV2_URID. This
+extensions defines standard levels which are expected to be understood by all
+implementations and should be sufficient in most cases, but advanced
+implementations may define and use additional levels to suit their needs.
+
+"""^^lv2:Markdown .
+
+log:Entry
+ a rdfs:Class ;
+ rdfs:label "Log Entry" ;
+ lv2:documentation """
+
+Subclasses of this are passed as the `type` parameter to LV2_Log_Log methods to
+describe the nature of the log entry.
+
+"""^^lv2:Markdown .
+
+log:Error
+ lv2:documentation """
+
+An error should only be posted when a serious unexpected error occurs, and
+should be actively shown to the user by the host.
+
+"""^^lv2:Markdown .
+
+log:Note
+ lv2:documentation """
+
+A note records some useful piece of information, but may be ignored. The host
+should provide passive access to note entries to the user.
+
+"""^^lv2:Markdown .
+
+log:Warning
+ lv2:documentation """
+
+A warning should be posted when an unexpected, but non-critical, error occurs.
+The host should provide passive access to warnings entries to the user, but may
+also choose to actively show them.
+
+"""^^lv2:Markdown .
+
+log:Trace
+ lv2:documentation """
+
+A trace 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 one may be posted in a real-time thread. It
+is assumed that if debug tracing is enabled, real-time performance is not a
+concern. However, the host MUST guarantee that posting a trace _is_ real-time
+safe if debug tracing is not enabled (for example, by simply ignoring the call
+as early as possible).
+
+"""^^lv2:Markdown .
+
+log:log
+ 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.
+
+"""^^lv2:Markdown .
diff --git a/lv2/log.lv2/log.ttl b/lv2/log.lv2/log.ttl
new file mode 100644
index 0000000..10f0acc
--- /dev/null
+++ b/lv2/log.lv2/log.ttl
@@ -0,0 +1,47 @@
+@prefix log: <http://lv2plug.in/ns/ext/log#> .
+@prefix lv2: <http://lv2plug.in/ns/lv2core#> .
+@prefix owl: <http://www.w3.org/2002/07/owl#> .
+@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
+
+<http://lv2plug.in/ns/ext/log>
+ a owl:Ontology ;
+ rdfs:label "LV2 Log" ;
+ rdfs:comment "A feature for writing log messages." ;
+ rdfs:seeAlso <log.meta.ttl> ;
+ owl:imports <http://lv2plug.in/ns/lv2core> .
+
+log:Entry
+ a rdfs:Class ;
+ rdfs:label "Entry" ;
+ rdfs:comment "A log entry." .
+
+log:Error
+ a rdfs:Class ;
+ rdfs:label "Error" ;
+ rdfs:subClassOf log:Entry ;
+ rdfs:comment "An error message." .
+
+log:Note
+ a rdfs:Class ;
+ rdfs:label "Note" ;
+ rdfs:subClassOf log:Entry ;
+ rdfs:comment "An informative message." .
+
+log:Warning
+ a rdfs:Class ;
+ rdfs:label "Warning" ;
+ rdfs:subClassOf log:Entry ;
+ rdfs:comment "A warning message." .
+
+log:Trace
+ a rdfs:Class ;
+ rdfs:label "Trace" ;
+ rdfs:subClassOf log:Entry ;
+ rdfs:comment "A debugging trace message." .
+
+log:log
+ a lv2:Feature ;
+ rdfs:label "log" ;
+ rdfs:comment "Logging feature." .
diff --git a/lv2/log.lv2/manifest.ttl b/lv2/log.lv2/manifest.ttl
new file mode 100644
index 0000000..f448ffe
--- /dev/null
+++ b/lv2/log.lv2/manifest.ttl
@@ -0,0 +1,8 @@
+@prefix lv2: <http://lv2plug.in/ns/lv2core#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+
+<http://lv2plug.in/ns/ext/log>
+ a lv2:Specification ;
+ lv2:minorVersion 2 ;
+ lv2:microVersion 4 ;
+ rdfs:seeAlso <log.ttl> .