This is an extended version of the AVFrame.opaque field, which can be used to attach arbitrary user information to an AVFrame. The usefulness of the opaque field is rather limited, because it can store only up to 32 bits of information (or 64 bit on 64 bit systems). It's not possible to set this field to a memory allocation, because there is no way to deallocate it correctly. The opaque_ref field circumvents this by letting the user set an AVBuffer, which makes the user data refcounted.
Showing the changes to doc/APIchanges (1 of 4 files). Show all
Unified · Split
| @@ -13,6 +13,9 @@ libavutil: 2015-08-28 · 12 unmodified lines | ||
| 13 | 13 | |
| 14 | 14 | API changes, most recent first: |
| 15 | 15 | |
| 16 | +2017-02-11 - xxxxxxx - lavu 55.32.0 - frame.h | |
| 17 | + Add AVFrame.opaque_ref. | |
| 18 | + | |
| 16 | 19 | 2017-02-xx - xxxxxxx - lavu 55.31.1 - frame.h |
| 17 | 20 | Allow passing the value of 0 (meaning "automatic") as the required alignment |
| 18 | 21 | to av_frame_get_buffer(). |