path: root/lv2/lv2plug.in/ns/ext/port-groups/port-groups.ttl

# LV2 Port Groups Extension
# Copyright 2009-2012 David Robillard <d@drobilla.net>
# Copyright 2008-2009 Lars Luthman <lars.luthman@gmail.com>
#
# 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 amb:  <http://ambisonics.ch/standards/channels/> .
@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 pg:   <http://lv2plug.in/ns/ext/port-groups#> .
@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/port-groups>
	a lv2:Specification ;
	rdfs:seeAlso <../../people/people.ttl> ;
	doap:license <http://opensource.org/licenses/isc> ;
	doap:name "LV2 Port Groups" ;
	doap:shortdesc "Multi-channel groups of LV2 ports." ;
	rdfs:comment "Defines semantic groupings of LV2 ports" ;
	doap:developer <http://lv2plug.in/ns/people#larsl> ,
		<http://drobilla.net/drobilla#me> .

pg:Group
	a rdfs:Class ;
	rdfs:label "A group of channels or parameters." ;
	rdfs:subClassOf [
		a owl:Restriction ;
		owl:onProperty lv2:symbol ;
		owl:someValuesFrom xsd:string ;
		owl:cardinality 1 ;
		rdfs:comment """
A pg:Group MUST have exactly one string lv2:symbol.  This symbol must be
unique according to the same rules as the lv2:symbol for an lv2:Port, where
group symbols and port symbols reside in the same namespace.  In other words,
a group on a plugin MUST NOT have the same symbol as another group or a port
on that plugin.  This makes it possible to uniquely reference a port or group
on a plugin with a single identifier and no context.
""" ;
	] ;
	rdfs:comment """
A grouping of ports that can be logically considered a single "stream", e.g.
two audio ports in a group may form a stereo stream.  The pg:source predicate
can also be used to describe this correspondence between separate ports/groups.
""" .

pg:Element
	a rdfs:Class ;
	rdfs:label "Element" ;
	rdfs:comment "An ordered element of a group." ;
	rdfs:subClassOf [
		a owl:Restriction ;
		owl:onProperty lv2:index ;
		owl:maxCardinality 1 ;
		rdfs:comment "An element has at most one lv2:index." ;
	] , [
		a owl:Restriction ;
		owl:onProperty lv2:designation ;
		owl:cardinality 1 ;
		rdfs:comment "An element MUST have exactly one lv2:designation." ;
	] ;
	rdfs:comment """
An element of a group, which has a designation and an optional index.
""" .

pg:element
	a rdf:Property ;
	rdfs:domain pg:Group ;
	rdfs:range pg:Element ;
	rdfs:label "element" ;
	rdfs:comment """
Indicates that a group has a certain element (a parameter or channel
designation with a possible index).
""" .

pg:sideChainOf
	a rdf:Property ;
	rdfs:label "Side-chain of" ;
	rdfs:comment """
Indicates that this port or group should be considered a "side chain" of
some other port or group.  The precise definition of "side chain" depends
on the plugin, but in general this group should be considered a modifier to
some other group, rather than an independent input itself.
""" .

pg:subGroupOf
	a rdf:Property ;
	rdfs:domain pg:Group ;
	rdfs:range pg:Group ;
	rdfs:label "Sub-group of" ;
	rdfs:comment """
Indicates that this group is a child of another group.  This property has no
meaning with respect to plugin execution, but the host may find this
information useful (e.g. to provide a compact user interface).  Note that being
a sub-group does not relax the restriction that the group MUST have a unique
symbol.
""" .

pg:source
	a rdf:Property ;
	rdfs:label "Source" ;
	rdfs:comment """
Indicates that this port or group should be considered the "result" of
some other port or group.  This property only makes sense on groups with
outputs when the source is a group with inputs.  This can be used to convey
a relationship between corresponding input and output groups with different
types, e.g. a mono->stereo plugin.
""" .

pg:mainGroup
	a rdf:Property ;
	rdfs:domain lv2:Plugin ;
	rdfs:range pg:Group ;
	rdfs:label "Main port group" ;
	rdfs:comment """
Indicates that this group should be considered the "main" inputs/outputs of
the plugin, e.g. it probably makes sense to just connect main groups and set
some controls.  A plugin MUST NOT have more than one pg:mainGroup property.
High-level hosts that simply want to insert an plugin in a given stream
should use this property to determine where the plugin 'fits'.
""" .

pg:inGroup
	a rdf:Property ;
	rdfs:domain lv2:Port ;
	rdfs:range pg:Group ;
	rdfs:label "In port group" ;
	rdfs:comment """
Indicates that this port is a part of a group of ports on the plugin.
""" .

pg:DiscreteGroup
	a rdfs:Class ;
	rdfs:subClassOf pg:Group ;
	rdfs:comment """
"Discrete" channel configurations.  These groups are divided into channels
where each represents a particular speaker location.  The position of sound
in one of these groups depends on a particular speaker configuration.
""" .

pg:left
	a lv2:Channel ;
	rdfs:label "Left" .

pg:right
	a lv2:Channel ;
	rdfs:label "Right" .

pg:center
	a lv2:Channel ;
	rdfs:label "Center" .

pg:side
	a lv2:Channel ;
	rdfs:label "Side" .

pg:centerLeft
	a lv2:Channel ;
	rdfs:label "Center Left" .

pg:centerRight
	a lv2:Channel ;
	rdfs:label "Center Right" .

pg:sideLeft
	a lv2:Channel ;
	rdfs:label "Side Left" .

pg:sideRight
	a lv2:Channel ;
	rdfs:label "Side Right" .

pg:rearLeft
	a lv2:Channel ;
	rdfs:label "Rear Left" .

pg:rearRight
	a lv2:Channel ;
	rdfs:label "Rear Right" .

pg:rearCenter
	a lv2:Channel ;
	rdfs:label "Rear Center" .

pg:lowFrequencyEffects
	a lv2:Channel ;
	rdfs:label "Low-Frequency Effects (LFE)" .

pg:MonoGroup
	a rdfs:Class ;
	rdfs:subClassOf pg:DiscreteGroup ;
	rdfs:label "Mono" ;
	pg:element [
		lv2:index 0 ;
		lv2:designation pg:center ;
	] .

pg:StereoGroup
	a rdfs:Class ;
	rdfs:subClassOf pg:DiscreteGroup ;
	rdfs:label "Stereo" ;
	pg:element [
		lv2:index 0 ;
		lv2:designation pg:left ;
	] , [
		lv2:index 1 ;
		lv2:designation pg:right ;
	] .

pg:MidSideGroup
	a rdfs:Class ;
	rdfs:subClassOf pg:DiscreteGroup ;
	rdfs:label "Mid-Side Stereo" ;
	pg:element [
		lv2:index 0 ;
		lv2:designation pg:center ;
	] , [
		lv2:index 1 ;
		lv2:designation pg:side ;
	] .

pg:ThreePointZeroGroup
	a rdfs:Class ;
	rdfs:subClassOf pg:DiscreteGroup ;
	rdfs:label "3.0 Surround" ;
	pg:element [
		lv2:index 0 ;
		lv2:designation pg:left ;
	] , [
		lv2:index 1 ;
		lv2:designation pg:right ;
	] , [
		lv2:index 2 ;
		lv2:designation pg:rearCenter ;
	] .

pg:FourPointZeroGroup
	a rdfs:Class ;
	rdfs:subClassOf pg:DiscreteGroup ;
	rdfs:label "4.0 Surround (Quadraphonic)" ;
	pg:element [
		lv2:index 0 ;
		lv2:designation pg:left ;
	] , [
		lv2:index 1 ;
		lv2:designation pg:center ;
	] , [
		lv2:index 2 ;
		lv2:designation pg:right ;
	] , [
		lv2:index 3 ;
		lv2:designation pg:rearCenter ;
	] .

pg:FivePointZeroGroup
	a rdfs:Class ;
	rdfs:subClassOf pg:DiscreteGroup ;
	rdfs:label "5.0 Surround (3-2 stereo)" ;
	pg:element [
		lv2:index 0 ;
		lv2:designation pg:left ;
	] , [
		lv2:index 1 ;
		lv2:designation pg:center ;
	] , [
		lv2:index 2 ;
		lv2:designation pg:right ;
	] , [
		lv2:index 3 ;
		lv2:designation pg:rearLeft ;
	] , [
		lv2:index 4 ;
		lv2:designation pg:rearRight ;
	] .

pg:FivePointOneGroup
	a rdfs:Class ;
	rdfs:subClassOf pg:DiscreteGroup ;
	rdfs:label "5.1 Surround (3-2 stereo)" ;
	pg:element [
		lv2:index 0 ;
		lv2:designation pg:left ;
	] , [
		lv2:index 1 ;
		lv2:designation pg:center ;
	] , [
		lv2:index 2 ;
		lv2:designation pg:right ;
	] , [
		lv2:index 3 ;
		lv2:designation pg:rearLeft ;
	] , [
		lv2:index 4 ;
		lv2:designation pg:rearRight ;
	] , [
		lv2:index 5 ;
		lv2:designation pg:lowFrequencyEffects ;
	] .

pg:SixPointOneGroup
	a rdfs:Class ;
	rdfs:subClassOf pg:DiscreteGroup ;
	rdfs:label "6.1 Surround" ;
	pg:element [
		lv2:index 0 ;
		lv2:designation pg:left ;
	] , [
		lv2:index 1 ;
		lv2:designation pg:center ;
	] , [
		lv2:index 2 ;
		lv2:designation pg:right ;
	] , [
		lv2:index 3 ;
		lv2:designation pg:sideLeft ;
	] , [
		lv2:index 4 ;
		lv2:designation pg:sideRight ;
	] , [
		lv2:index 5 ;
		lv2:designation pg:rearCenter ;
	] , [
		lv2:index 6 ;
		lv2:designation pg:lowFrequencyEffects ;
	] .

pg:SevenPointOneGroup
	a rdfs:Class ;
	rdfs:subClassOf pg:DiscreteGroup ;
	rdfs:label "7.1 Surround" ;
	pg:element [
		lv2:index 0 ;
		lv2:designation pg:left ;
	] , [
		lv2:index 1 ;
		lv2:designation pg:center ;
	] , [
		lv2:index 2 ;
		lv2:designation pg:right ;
	] , [
		lv2:index 3 ;
		lv2:designation pg:sideLeft ;
	] , [
		lv2:index 4 ;
		lv2:designation pg:sideRight ;
	] , [
		lv2:index 5 ;
		lv2:designation pg:rearLeft ;
	] , [
		lv2:index 6 ;
		lv2:designation pg:rearRight ;
	] , [
		lv2:index 7 ;
		lv2:designation pg:lowFrequencyEffects ;
	] .

pg:SevenPointOneWideGroup
	a rdfs:Class ;
	rdfs:subClassOf pg:DiscreteGroup ;
	rdfs:label "7.1 Surround (Wide)" ;
	pg:element [
		lv2:index 0 ;
		lv2:designation pg:left ;
	] , [
		lv2:index 1 ;
		lv2:designation pg:centerLeft ;
	] , [
		lv2:index 2 ;
		lv2:designation pg:center ;
	] , [
		lv2:index 3 ;
		lv2:designation pg:centerRight ;
	] , [
		lv2:index 4 ;
		lv2:designation pg:right ;
	] , [
		lv2:index 5 ;
		lv2:designation pg:rearLeft ;
	] , [
		lv2:index 6 ;
		lv2:designation pg:rearRight ;
	] , [
		lv2:index 7 ;
		lv2:designation pg:lowFrequencyEffects ;
	] .

pg:AmbisonicGroup
	a rdfs:Class ;
	rdfs:subClassOf pg:Group ;
	rdfs:comment """
"Ambisonic" channel configurations.  These groups are divided into channels
which together represent a position in an abstract n-dimensional space.
The position of sound in one of these groups does not depend on a particular
speaker configuration; a decoder can be used to convert an ambisonic stream
for any speaker configuration.
""" .

pg:AmbisonicBH1P0Group
	a rdfs:Class ;
	rdfs:subClassOf pg:AmbisonicGroup ;
	rdfs:label "Ambisonic B stream of horizontal order 1 and peripheral order 0." ;
	pg:element [
		lv2:index 0 ;
		lv2:designation amb:ACN0 ;
	] , [
		lv2:index 1 ;
		lv2:designation amb:ACN1 ;
	] , [
		lv2:index 2 ;
		lv2:designation amb:ACN3 ;
	] .

pg:AmbisonicBH1P1Group
	a rdfs:Class ;
	rdfs:subClassOf pg:AmbisonicGroup ;
	rdfs:label "Ambisonic B stream of horizontal order 1 and peripheral order 1." ;
	pg:element [
		lv2:index 0 ;
		lv2:designation amb:ACN0 ;
	] , [
		lv2:index 1 ;
		lv2:designation amb:ACN1 ;
	] , [
		lv2:index 2 ;
		lv2:designation amb:ACN2 ;
	] , [
		lv2:index 3 ;
		lv2:designation amb:ACN3 ;
	] .

pg:AmbisonicBH2P0Group
	a rdfs:Class ;
	rdfs:subClassOf pg:AmbisonicGroup ;
	rdfs:label "Ambisonic B stream of horizontal order 2 and peripheral order 0." ;
	pg:element [
		lv2:index 0 ;
		lv2:designation amb:ACN0 ;
	] , [
		lv2:index 1 ;
		lv2:designation amb:ACN1 ;
	] , [
		lv2:index 2 ;
		lv2:designation amb:ACN3 ;
	] , [
		lv2:index 3 ;
		lv2:designation amb:ACN4 ;
	] , [
		lv2:index 4 ;
		lv2:designation amb:ACN8 ;
	] .

pg:AmbisonicBH2P1Group
	a rdfs:Class ;
	rdfs:subClassOf pg:AmbisonicGroup ;
	rdfs:label "Ambisonic B stream of horizontal order 2 and peripheral order 1." ;
	pg:element [
		lv2:index 0 ;
		lv2:designation amb:ACN0 ;
	] , [
		lv2:index 1 ;
		lv2:designation amb:ACN1 ;
	] , [
		lv2:index 2 ;
		lv2:designation amb:ACN2 ;
	] , [
		lv2:index 3 ;
		lv2:designation amb:ACN3 ;
	] , [
		lv2:index 4 ;
		lv2:designation amb:ACN4 ;
	] , [
		lv2:index 5 ;
		lv2:designation amb:ACN8 ;
	] .

pg:AmbisonicBH2P2Group
	a rdfs:Class ;
	rdfs:subClassOf pg:AmbisonicGroup ;
	rdfs:label "Ambisonic B stream of horizontal order 2 and peripheral order 2." ;
	pg:element [
		lv2:index 0 ;
		lv2:designation amb:ACN0 ;
	] , [
		lv2:index 1 ;
		lv2:designation amb:ACN1 ;
	] , [
		lv2:index 2 ;
		lv2:designation amb:ACN2 ;
	] , [
		lv2:index 3 ;
		lv2:designation amb:ACN3 ;
	] , [
		lv2:index 4 ;
		lv2:designation amb:ACN4 ;
	] , [
		lv2:index 5 ;
		lv2:designation amb:ACN5 ;
	] , [
		lv2:index 6 ;
		lv2:designation amb:ACN6 ;
	] , [
		lv2:index 7 ;
		lv2:designation amb:ACN7 ;
	] , [
		lv2:index 8 ;
		lv2:designation amb:ACN8 ;
	] .

pg:AmbisonicBH3P0Group
	a rdfs:Class ;
	rdfs:subClassOf pg:AmbisonicGroup ;
	rdfs:label "Ambisonic B stream of horizontal order 3 and peripheral order 0." ;
	pg:element [
		lv2:index 0 ;
		lv2:designation amb:ACN0 ;
	] , [
		lv2:index 1 ;
		lv2:designation amb:ACN1 ;
	] , [
		lv2:index 2 ;
		lv2:designation amb:ACN3 ;
	] , [
		lv2:index 3 ;
		lv2:designation amb:ACN4 ;
	] , [
		lv2:index 4 ;
		lv2:designation amb:ACN8 ;
	] , [
		lv2:index 5 ;
		lv2:designation amb:ACN9 ;
	] , [
		lv2:index 6 ;
		lv2:designation amb:ACN15 ;
	] .

pg:AmbisonicBH3P1Group
	a rdfs:Class ;
	rdfs:subClassOf pg:AmbisonicGroup ;
	rdfs:label "Ambisonic B stream of horizontal order 3 and peripheral order 1." ;
	pg:element [
		lv2:index 0 ;
		lv2:designation amb:ACN0 ;
	] , [
		lv2:index 1 ;
		lv2:designation amb:ACN1 ;
	] , [
		lv2:index 2 ;
		lv2:designation amb:ACN2 ;
	] , [
		lv2:index 3 ;
		lv2:designation amb:ACN3 ;
	] , [
		lv2:index 4 ;
		lv2:designation amb:ACN4 ;
	] , [
		lv2:index 5 ;
		lv2:designation amb:ACN8 ;
	] , [
		lv2:index 6 ;
		lv2:designation amb:ACN9 ;
	] , [
		lv2:index 7 ;
		lv2:designation amb:ACN15 ;
	] .

pg:AmbisonicBH3P2Group
	a rdfs:Class ;
	rdfs:subClassOf pg:AmbisonicGroup ;
	rdfs:label "Ambisonic B stream of horizontal order 3 and peripheral order 2." ;
	pg:element [
		lv2:index 0 ;
		lv2:designation amb:ACN0 ;
	] , [
		lv2:index 1 ;
		lv2:designation amb:ACN1 ;
	] , [
		lv2:index 2 ;
		lv2:designation amb:ACN2 ;
	] , [
		lv2:index 3 ;
		lv2:designation amb:ACN3 ;
	] , [
		lv2:index 4 ;
		lv2:designation amb:ACN4 ;
	] , [
		lv2:index 5 ;
		lv2:designation amb:ACN5 ;
	] , [
		lv2:index 6 ;
		lv2:designation amb:ACN6 ;
	] , [
		lv2:index 7 ;
		lv2:designation amb:ACN7 ;
	] , [
		lv2:index 8 ;
		lv2:designation amb:ACN8 ;
	] , [
		lv2:index 9 ;
		lv2:designation amb:ACN9 ;
	] , [
		lv2:index 10 ;
		lv2:designation amb:ACN15 ;
	] .

pg:AmbisonicBH3P3Group
	a rdfs:Class ;
	rdfs:subClassOf pg:AmbisonicGroup ;
	rdfs:label "Ambisonic B stream of horizontal order 3 and peripheral order 3." ;
	pg:element [
		lv2:index 0 ;
		lv2:designation amb:ACN0 ;
	] , [
		lv2:index 1 ;
		lv2:designation amb:ACN1 ;
	] , [
		lv2:index 2 ;
		lv2:designation amb:ACN2 ;
	] , [
		lv2:index 3 ;
		lv2:designation amb:ACN3 ;
	] , [
		lv2:index 4 ;
		lv2:designation amb:ACN4 ;
	] , [
		lv2:index 5 ;
		lv2:designation amb:ACN5 ;
	] , [
		lv2:index 6 ;
		lv2:designation amb:ACN6 ;
	] , [
		lv2:index 7 ;
		lv2:designation amb:ACN7 ;
	] , [
		lv2:index 8 ;
		lv2:designation amb:ACN8 ;
	] , [
		lv2:index 9 ;
		lv2:designation amb:ACN9 ;
	] , [
		lv2:index 10 ;
		lv2:designation amb:ACN10 ;
	] , [
		lv2:index 11 ;
		lv2:designation amb:ACN11 ;
	] , [
		lv2:index 12 ;
		lv2:designation amb:ACN12 ;
	] , [
		lv2:index 13 ;
		lv2:designation amb:ACN13 ;
	] , [
		lv2:index 14 ;
		lv2:designation amb:ACN14 ;
	] , [
		lv2:index 15 ;
		lv2:designation amb:ACN15 ;
	] .