api update

Original commit message from CVS:
api update
This commit is contained in:
Thomas Vander Stichele 2004-06-11 15:19:57 +00:00
parent e5c9a61a6b
commit 4bd086921c

View file

@ -1,40 +1,25 @@
GStreamer data protocol GStreamer data protocol
Intended to wrap GstData objects in a line protocol for use with
Intended to wrap GstData objects in a line protocol for use with pipe / network elements.
pipe/network elements. IDEAS-- -- -*for transporting buffers, have a function that creates a header for a given buffer to be written before the buffer.This way, you don 't lose
IDEAS
-----
* for transporting buffers, have a function that creates a header for
a given buffer to be written before the buffer. This way, you don't lose
time creating a GDP buffer from the buffer time creating a GDP buffer from the buffer
* allow for CRC'ing of the GstBuffer, optionally * allow for CRC' ing of the GstBuffer, optionally * have a version number of the protocol * optimizing the header for size is not useful since the GstData structure
* have a version number of the protocol already contains more than 32 bytes anyway, making up half the header size PROTOCOL-- -- ----*1 byte GDP major
* optimizing the header for size is not useful since the GstData structure version (0)
already contains more than 32 bytes anyway, making up half the header size *1 byte GDP minor version (1)
* 1 byte GDP flags
PROTOCOL * 1 byte GDP data type
-------- 1 for buffer, 2 caps, 65 + for events
* 1 byte GDP major version (0) * 4 byte length of "payload"
* 1 byte GDP minor version (1) * 8 byte timestamp of buffer / event
* 1 byte GDP flags * 8 byte duration of buffer
* 1 byte GDP data type * 8 byte offset
1 for buffer, 2 caps, 65+ for events * 8 byte offset_end
* 4 byte length of "payload" * 2 byte buffer data flags * 14 byte future extension (ABI padding)
* 8 byte timestamp of buffer/event *2 byte optional header crc
* 8 byte duration of buffer * 2 byte optional payload crc
* 8 byte offset * (length) payload
* 8 byte offset_end header:60 bytes
* 2 byte buffer data flags PROTOCOL CHANGELOG-- --
* 14 byte future extension (ABI padding) --------------0.1:added two bytes for buffer flags all numbers use
* 2 byte optional header crc network byte ordering.
* 2 byte optional payload crc
* (length) payload
header: 60 bytes
PROTOCOL CHANGELOG
------------------
0.1: added two bytes for buffer flags
all numbers use network byte ordering.