upipe/upipe_helper_uref_stream.h header reference

Upipe helper functions to work on input as an uref stream More

• upipe/ubase.h
• upipe/ulist.h
• upipe/ubuf.h
• upipe/uref.h
• upipe/uref_attr.h
• upipe/uref_block.h
• upipe/uref_clock.h
• upipe/upipe.h

• UPIPE_HELPER_UREF_STREAM

Upipe helper functions to work on input as an uref stream

This macro is declared in upipe/upipe_helper_uref_stream.h source file, line 95.

This macro declares four functions allowing to process input urefs as an uref stream.

You must add three members to your private pipe structure, for instance:

You must also declare UPIPE_HELPER_UPIPE prior to using this macro.

Supposing the name of your structure is upipe_foo, it declares:

• void upipe_foo_init_uref_stream(struct upipe_foo *s)

  Initializes the fields.

• void upipe_foo_append_uref_stream(struct upipe_foo *s, struct uref *uref)

  Appends the given uref to the uref stream.

• void upipe_foo_consume_uref_stream(struct upipe_foo *s, size_t consumed)

  Consumes the given number of urefs from the uref stream.

• void upipe_foo_clean_uref_stream(struct upipe_foo *s)

  Releases all buffers.

Please take note that this function internally uses uref_attr_set_priv and uref_attr_get_priv.

Parameters list:

• STRUCTURE: name of your private upipe structure
• NEXT_UREF: name of the struct uref field of your private upipe structure
• NEXT_UREF_SIZE: name of the size_t field of your private upipe structure
• UREFS: name of the struct uchain field of your private upipe structure
• APPEND_CB: function (struct upipe *) that will be called when a new uref starts being consumed (may be NULL)

This macro is declared in upipe/upipe_helper_uref_stream.h source file, line 31.