Changeset 2123

Show
Ignore:
Timestamp:
06/16/09 20:42:43 (15 months ago)
Author:
drobilla
Message:

Clean up port groups extension.

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • trunk/lv2/ext/port_groups/lv2_port_groups.ttl

    r2118 r2123  
    2222# OTHER DEALINGS IN THE SOFTWARE. 
    2323 
    24 @prefix pg:   <http://lv2plug.in/ns/ext/port-groups#> . 
     24@prefix pg:   <http://lv2plug.in/ns/dev/port-groups#> . 
    2525@prefix lv2:  <http://lv2plug.in/ns/lv2core#> . 
    2626@prefix rdf:  <http://www.w3.org/1999/02/22-rdf-syntax-ns#> . 
     
    3131@prefix foaf: <http://xmlns.com/foaf/0.1/> . 
    3232 
    33 <http://lv2plug.in/ns/ext/port-groups> a lv2:Specification ; 
     33<http://lv2plug.in/ns/dev/port-groups> a lv2:Specification ; 
    3434        doap:license <http://usefulinc.com/doap/licenses/mit> ; 
    3535        doap:name       "LV2 Port Groups" ; 
     
    5555                owl:hasValue   xsd:string ; 
    5656        rdfs:comment   """ 
    57 A pg:Group MUST have at least one string lv2:symbol.  This symbol must 
    58 be unique according to the same rules as the lv2:symbol for an lv2:Port, 
    59 where group symbols and port symbols reside in the same namespace. 
    60 That is, a group on a plugin MUST NOT have the same symbol as a port 
    61 on that plugin. 
    62 Rationale: Hosts may find it useful to construct an identifier to refer 
    63 to groups for the same reasons this is useful for ports. 
     57A pg:Group MUST have at least one string lv2:symbol.  This symbol must be 
     58unique according to the same rules as the lv2:symbol for an lv2:Port, where 
     59group symbols and port symbols reside in the same namespace.  In other words, 
     60a group on a plugin MUST NOT have the same symbol as another group or a port 
     61on that plugin.  Rationale: Hosts or bindings may find it useful to construct 
     62an identifier to refer to groups for the same reasons this is useful for ports. 
    6463""" 
    6564        ] ; 
    6665        rdfs:comment """ 
    6766A grouping of ports that can be logically considered a "stream", e.g. 
    68 two audio ports in a group forming a stereo stream.  Both inputs and 
    69 outputs can form a group, which allows describing to the host which 
    70 outputs correspond to which inputs.  In this case, outputs with a given 
    71 role correspond to the inputs in the same group with that role (though 
    72 the output and input roles of a group do not necessarily match). 
     67two audio ports in a group forming a stereo stream.  Both inputs and outputs 
     68can form a group, which allows describing to the host which outputs correspond 
     69to which inputs.  In this case, outputs with a given role correspond to the 
     70inputs in the same group with that role (though the output and input roles 
     71of a group do not necessarily match).  The pg:source predicate can also be 
     72used to describe this correspondence between separate ports/groups. 
    7373""" . 
    7474 
     
    9090 
    9191pg:sideChainOf a rdf:Property ; 
    92         rdfs:domain  pg:Group ; 
    93         rdfs:range   pg:Group ; 
     92        rdfs:domain  pg:Group , lv2:Port ; 
     93        rdfs:range   pg:Group , lv2:Port ; 
    9494        rdfs:label   "Side-chain of" ; 
    9595        rdfs:comment """ 
    96 Indicates that this port group should be considered a "side chain" of some 
    97 other group.  The precise definition of "side chain" depends on the plugin, 
    98 but in general this group should be considered a modifier to some other 
    99 group, rather than an independent input itself. 
     96Indicates that this port or group should be considered a "side chain" of 
     97some other port or group.  The precise definition of "side chain" depends 
     98on the plugin, but in general this group should be considered a modifier to 
     99some other group, rather than an independent input itself. 
    100100""" . 
    101101 
    102102pg:source a rdf:Property ; 
    103         rdfs:domain  pg:Group ; 
    104         rdfs:range   pg:Group ; 
     103        rdfs:domain  pg:Group , lv2:Port ; 
     104        rdfs:range   pg:Group , lv2:Port ; 
    105105        rdfs:label   "Source group" ; 
    106106        rdfs:comment """ 
    107 Indicates that this port group should be considered the "result" of some 
    108 other group.  This property only makes sense on groups with outputs when 
    109 the source is a group with inputs.  This can be used to convey a relationship 
    110 between corresponding input and output groups with different types, e.g. 
    111 a mono->stereo plugin. 
     107Indicates that this port or group should be considered the "result" of 
     108some other port or group.  This property only makes sense on groups with 
     109outputs when the source is a group with inputs.  This can be used to convey 
     110a relationship between corresponding input and output groups with different 
     111types, e.g.  a mono->stereo plugin. 
    112112""" . 
    113113 
     
    126126        rdfs:label   "Main port group" ; 
    127127        rdfs:comment """ 
    128 Indicates that this port group should be considered the "main" inputs/outputs 
    129 of the plugin, e.g. a stereo effect has a "main" group with 2 inputs and 2 
    130 outputs.  A plugin MUST NOT have more than one :mainGroup property.  High-level 
    131 hosts that simply want to insert an plugin in a given stream should use 
    132 this property to determine where the plugin 'fits'. 
     128Indicates that this group should be considered the "main" inputs/outputs of 
     129the plugin, e.g. it probably makes sense to just connect main groups and set 
     130some controls.  A plugin MUST NOT have more than one :mainGroup property. 
     131High-level hosts that simply want to insert an plugin in a given stream 
     132should use this property to determine where the plugin 'fits'. 
    133133""" . 
    134134 
     
    139139        rdfs:comment """ 
    140140Indicates that this port is a part of a group of ports on the plugin. 
    141 Ports that have a meaningful "role" that may be useful to hosts SHOULD 
    142 also have a :role property, otherwise ports in the group have no meaningful 
    143 order.""" . 
     141Ports that have a meaningful "role" that may be useful to hosts SHOULD also 
     142have a :role property, otherwise ports in the group have no meaningful order. 
     143""" . 
    144144 
    145145pg:Role a rdfs:Class ; 
    146146        rdfs:label   "Port role" ; 
    147147        rdfs:comment """ 
    148 The role of a port with respect to its plugin or group. 
    149  
    150 If the port is a member of a group (has an :inGroup property) the 
    151 role is relevant with respect to that group.  Otherwise the role 
    152 is relevant with respect to the plugin. 
     148The role of a port with respect to its plugin or group.  If the port is a 
     149member of a group (has an :inGroup property) the role is relevant with respect 
     150to that group.  Otherwise the role is relevant with respect to the plugin. 
    153151""" . 
    154152