| METADATA ON BUFFERS IS OUTDATED |
| ------------------------------- |
| |
| |
| Buffer mutability properties are the most important part of gst, and |
| similarly are the most complex. |
| |
| The simple case is that a buffer is created, memory allocated, data put |
| in it, and passed to the next filter. That filter reads the data, does |
| something (like creating a new buffer and decoding into it), and |
| unreferences the buffer. This causes the data to be freed and the buffer |
| to be destroyed. |
| |
| A more complex case is when the filter modifies the data in place. It |
| does so and simply passes on the buffer to the next element. This is just |
| as easy to deal with. |
| |
| If the second filter adds metadata to the buffer, it just has to add the |
| pointer to the list. The next element simply traverses the list and |
