summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorWim Taymans <wtaymans@redhat.com>2017-01-19 18:10:00 +0100
committerWim Taymans <wtaymans@redhat.com>2017-01-19 18:10:00 +0100
commit0398f997d78bc6174e05140891a91cce8d3b15a2 (patch)
treef28e4bf704b6198d7834fc8b407e1b827f68d936 /doc
parent7a9dc2c4fdbdaf881a29eab6b3a192500665f666 (diff)
cleanups
Update some docs Remove special structs for some events Remove some unused flags Update some plugins
Diffstat (limited to 'doc')
-rw-r--r--doc/design.txt46
1 files changed, 8 insertions, 38 deletions
diff --git a/doc/design.txt b/doc/design.txt
index 9fdfd2ec..5bf47714 100644
--- a/doc/design.txt
+++ b/doc/design.txt
@@ -1,7 +1,7 @@
Pinos
-----
-The idea is to make a DBus service where you can provide
+The idea is to make a server where you can provide
and consume media to/from.
Some of the requirements are:
@@ -16,39 +16,16 @@ only and should be able to handle compressed video and other
streamable media as well.
The design is in some part inspired by pulseaudio, hence its original
-name. Increasinly we also seem to add functionality of jack.
+name. Increasinly we also seem to add functionality of jack and
+GStreamer.
-Objects
--------
+Protocol
+--------
-Daemon1: the main pinos daemon
- /org/pinos/server
-Client1: a connected client, the result object from call
- Daemon1.ConnectClient
- /org/pinos/client*
-Node1: a processing node, this can be a source, sink or transform
- element. Nodes have ports
- /org/pinos/node*
-Link1: a link between 2 ports
- /org/pinos/link*
-
-
-DBus protocol
--------------
-
-The main daemon is registered on the session bus with name: org.pinos
-
-Various Node1 objects are registered in the server based on the available
-sources or sinks of content. Node1 has properties and its ports have format
-descriptions of what it can provide or consume.
-
-First a client needs to register a Node1 with pinos by calling
-org.pinos.Daemon1.CreateClientNode(). This creates a new Client1 object and
-a Node 1 object that the client must use for further communication.
-
-A client then needs to use the pinos protocol to control the Node1. It will
-also receive commands and notifications from pinos.
+The protocol is similar to wayland but with custom
+serialization/deserialization of messages. This is because the datastructures
+in the messages are more complicated.
fd management
@@ -58,13 +35,6 @@ Clients receive fds with buffers and memory after a format was negotiated.
Updates to these buffers are notified by a message containing the id of the
buffer.
-* client remove
-
-When a client disconnects from pinos, it must have released all fd-indexes
-that it received. Pinos will force a release and will reuse the fd-indexes
-when the client disconnects.
-
-
Wire
----