# LV2 URID Extension # Copyright 2011 Gabriel M. Beddingfield # Copyright 2008-2011 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 dcs: . @prefix doap: . @prefix foaf: . @prefix lv2: . @prefix rdfs: . @prefix urid: . a foaf:Person ; foaf:name "David Robillard" ; foaf:mbox ; rdfs:seeAlso . _:gabrbedd a foaf:Person ; foaf:name "Gabriel M. Beddingfield" ; foaf:homepage . a lv2:Specification ; rdfs:seeAlso ; doap:license ; doap:name "LV2 URID" ; doap:shortdesc "Features for mapping URIs to and from integers." ; doap:release [ doap:revision "1.0" ; doap:created "2011-11-21" ; dcs:blame ; dcs:changeset [ dcs:item [ rdfs:label "Initial release." ] ] ] ; doap:developer _:gabrbedd ; doap:maintainer ; lv2:documentation """

This extension defines a simple mechanism for plugins to map URIs to and from integers, usually for performance reasons (e.g. processing events typed by URIs in real time). Typically, plugins map URIs to integers for things they "understand" at instantiation time, and store those values for use in the audio thread without doing any string comparison. This allows for the extensibility of RDF but with the performance of integers.

This extension is intended as an improved and simplified replacement for the uri-map extension, since the map context parameter has been found problematic. New implementations are strongly encouraged to use this extension for URI mapping.

""" . urid:map a lv2:Feature ; lv2:documentation """

A feature which is used to map URIs to integers. To support this feature, the host must pass an LV2_Feature to LV2_Descriptor::instantiate() with URI LV2_URID__map and data pointed to an instance of LV2_URID_Map.

""" . urid:unmap a lv2:Feature ; lv2:documentation """

A feature which is used to unmap URIs previously mapped to integers by urid:map. To support this feature, the host must pass an LV2_Feature to LV2_Descriptor::instantiate() with URI LV2_URID__unmapl and data pointed to an instance of LV2_URID_Unmap.

""" .