aboutsummaryrefslogtreecommitdiffstats
path: root/lv2/lv2plug.in/ns/ext/resize-port/resize-port.ttl
blob: 72f81a2e6c63597dfd42d100bb31eaf937e27e8d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
# LV2 Resize Port Extension
# Copyright 2007-2012 David Robillard <d@drobilla.net>
#
# 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: <http://usefulinc.com/ns/doap#> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@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 rsz:  <http://lv2plug.in/ns/ext/resize-port#> .
@prefix xsd:  <http://www.w3.org/2001/XMLSchema#> .

<http://lv2plug.in/ns/ext/resize-port>
	a lv2:Specification ,
		lv2:Feature ;
	rdfs:seeAlso <resize-port.h> ,
		<../../people/people.ttl> ;
	doap:name "LV2 Resize Port Extension" ;
	doap:shortdesc "Dynamically sized LV2 port buffers." ;
	doap:developer <http://drobilla.net/drobilla#me> ;
	lv2:documentation """
<p>An extension that allows LV2 plugins to request a resize of an output
port.</p>

<p>Any host which supports this extension must pass an LV2_Feature to the
plugin's instantiate method with URI http://lv2plug.in/ns/ext/resize-port and a
pointer to a LV2_Resize_Port_Feature structure.  This structure provides a
resize_port function which plugins may use to resize output port buffers as
necessary.</p>

<p>This extension also defines several predicates useful for describing the
amount of space required for a particular port buffer.</p>
""" .

rsz:asLargeAs
	a rdf:Property ,
		owl:DatatypeProperty ;
	rdfs:domain lv2:Port ;
	rdfs:range lv2:Symbol ;
	rdfs:label "as large as" ;
	rdfs:comment """
Indicates that a port requires at least as much buffer space as the port
with the given symbol on the same plugin instance.  This may be used for
any ports, but is generally most useful to indicate an output port must
be at least as large as some input port (because it will copy from it).
If a port is asLargeAs several ports, it is asLargeAs the largest such port
(not the sum of those ports' sizes).

The host guarantees that whenever an ObjectPort's run method is called,
any output O that is obj:asLargeAs an input I is connected to a buffer large
enough to copy I, or NULL if the port is lv2:connectionOptional.
""" .

rsz:minimumSize
	a rdf:Property ,
		owl:DatatypeProperty ,
		owl:FunctionalProperty ;
	rdfs:domain lv2:Port ;
	rdfs:range xsd:nonNegativeInteger ;
	rdfs:label "minimum size" ;
	rdfs:comment """
Indicates that a port requires a buffer at least this large, in bytes.
Any host that supports the resize-port feature MUST connect any port with a
minimumSize specified to a buffer at least as large as the value given for
this property.  Any host, especially those that do NOT support dynamic port
resizing, SHOULD do so or reduced functionality may result.
""" .