pipewire/pinos/dbus/org.pinos.xml

<!DOCTYPE node PUBLIC
    "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN"
    "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd" >
<node xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd">
  <!--
      org.pinos.Daemon1:
      @short_description: Main interface for the pinos daemon

      Interface to get properties from the pinos daemon and to
      establish a client connection.
  -->
  <interface name='org.pinos.Daemon1'>
    <!-- UserName: Name of the user that started the daemon -->
    <property name='UserName' type='s' access='read' />
    <!-- HostName: Name of the machine the daemon is running on -->
    <property name='HostName' type='s' access='read' />
    <!-- Version: Version of the daemon -->
    <property name='Version' type='s' access='read' />
    <!-- Name: Name of the daemon -->
    <property name='Name' type='s' access='read' />
    <!-- Cookie: A random cookie for identifying this instance of Pinos -->
    <property name='Cookie' type='u' access='read' />
    <!-- Properties: Extra properties of the daemon -->
    <property name='Properties' type='a{sv}' access='read' />

    <!-- CreateNode:
         @factory_name: the factory name to use for the node
         @name: the name of the node
         @Properties: extra properties
         @node: the Node1 object path

         Create a new Node with given name and properties
    -->
    <method name='CreateNode'>
      <arg type='s' name='factory_name' direction='in' />
      <arg type='s' name='name' direction='in' />
      <arg type='a{sv}' name='properties' direction='in'/>
      <arg type='o' name='node' direction='out'/>
    </method>

    <!-- CreateClientNode:
         @name: the name of the node
         @Properties: extra properties
         @node: the Node1 object path

         Create a new Node
    -->
    <method name='CreateClientNode'>
      <arg type='s' name='name' direction='in' />
      <arg type='a{sv}' name='properties' direction='in'/>
      <arg type='o' name='node' direction='out'/>
      <arg type='h' name='fd' direction='out'/>
    </method>

    <method name='RegisterClientNode'>
      <arg type='a{sv}' name='properties' direction='in'/>
      <arg type='o' name='node' direction='in'/>
      <arg type='h' name='fd' direction='out'/>
    </method>

  </interface>

  <interface name='org.pinos.Client1'>
    <!-- Sender: Sender of the client -->
    <property name='Sender' type='s' access='read' />
    <!-- Name: Properties of the client -->
    <property name='Properties' type='a{sv}' access='read' />
  </interface>

  <!--
      org.pinos.Node1:
      @short_description: A processing node

      A node is an object that can consume and/or produce media.
  -->
  <interface name='org.pinos.Node1'>
    <!-- Name: the name of the node -->
    <property name='Name' type='s' access='read' />
    <!-- Owner: the owner path of this node -->
    <property name='Owner' type='s' access='read' />
    <!-- Properties: extra node properties -->
    <property name='Properties' type='a{sv}' access='read' />

    <property name='Ports' type='a(uu)' access='read' />

    <method name='Link'>
      <arg type='o' name='input_node' direction='in' />
      <arg type='s' name='format_filter' direction='in'/>
      <arg type='a{sv}' name='properties' direction='in'/>
      <arg type='o' name='link' direction='out' />
    </method>

    <!-- state: state of the node
          -1 = the node is in error
          0 = the node is suspended, this means that the node is not
              processing any data and has closed all devices if any
          1 = the node is initializing
          2 = the node is idle, this means no channel is consuming
              the data. An idle node can become suspended.
          3 = the node is running
    -->
    <property name='State' type='u' access='read' />

    <!-- Activate:

         Set the node ready for processing
    -->
    <method name='Activate'>
    </method>

    <method name='Deactivate'>
    </method>

    <!-- Remove:

         Remove the node
    -->
    <method name='Remove'/>
  </interface>

  <interface name='org.pinos.ClientNode1'>
    <!-- Info: extra node info -->
    <property name='Info' type='a{sv}' access='read' />
    <!-- State: the node state -->
    <property name='State' type='u' access='read' />

    <property type='a{sv}' name='props' access='read'/>

    <property type='u' name='max_input_ports' access='read'/>
    <property type='au' name='input_ports' access='read'/>
    <property type='u' name='max_output_ports' access='read'/>
    <property type='uau' name='output_ports' access='read'/>

    <method name='SetProps'>
      <arg type='a{sv}' name='props' direction='in'/>
    </method>

    <method name='SendCommand'>
      <arg type='sv' name='command' direction='in'/>
    </method>

    <signal name='Event'>
      <arg type='sv' name='event'/>
    </signal>

    <method name='AddPort'>
      <arg type='uu' name='port' direction='in'/>
    </method>
    <method name='RemovePort'>
      <arg type='uu' name='port' direction='in'/>
    </method>

    <method name='GetPortInfo'>
      <arg type='uu' name='port' direction='in'/>
      <arg type='a{sv}' name='props' direction='out'/>
      <arg type='ay' name='format' direction='out'/>
      <arg type='ay' name='info' direction='out'/>
    </method>

    <method name='PortEnumFormats'>
      <arg type='uu' name='port' direction='in'/>
      <arg type='ay' name='filter' direction='in'/>
      <arg type='x' name='state' direction='in'/>
      <arg type='ay' name='format' direction='out'/>
      <arg type='x' name='new_state' direction='out'/>
    </method>

    <method name='PortSetFormat'>
      <arg type='uu' name='port' direction='in'/>
      <arg type='u' name='flags' direction='in'/>
      <arg type='ay' name='format' direction='in'/>
    </method>

    <signal name='PortChanged'>
      <arg type='uu' name='port'/>
      <arg type='u' name='mask'/>
      <arg type='a{sv}' name='props'/>
      <arg type='ay' name='format'/>
      <arg type='ay' name='info'/>
    </signal>

    <method name='PortSetProps'>
      <arg type='uu' name='port' direction='in'/>
      <arg type='a{sv}' name='props' direction='in'/>
    </method>

    <method name='PortUseBuffers'>
      <arg type='uu' name='port' direction='in'/>
      <arg type='ah' name='mem' direction='in'/>
      <arg type='ay' name='buffers' direction='in'/>
    </method>
  </interface>

  <interface name='org.pinos.Link1'>
    <!-- Owner: the owner path of this link -->
    <property name='Owner' type='s' access='read' />

    <property name='OutputNode' type='o' access='read' />
    <property name='OutputPort' type='u' access='read' />
    <property name='InputNode' type='o' access='read' />
    <property name='InputPort' type='u' access='read' />

    <property name='Properties' type='a{sv}' access='read' />

    <property name='Format' type='s' access='read' />

    <method name='Remove'/>

  </interface>
</node>