upipe/ubuf_pic_mem.h header reference

Upipe ubuf manager for picture formats with umem storage More

• upipe/ubase.h
• upipe/ubuf.h
• upipe/ubuf_pic.h

• int ubuf_pic_mem_mgr_add_plane(struct ubuf_mgr *mgr, const char *chroma, uint8_t hsub, uint8_t vsub, uint8_t macropixel_size)
• struct ubuf_mgr * ubuf_pic_mem_mgr_alloc(uint16_t ubuf_pool_depth, uint16_t shared_pool_depth, struct umem_mgr *umem_mgr, uint8_t macropixel, int hprepend, int happend, int vprepend, int vappend, int align, int align_hmoffset)
• struct ubuf_mgr * ubuf_pic_mem_mgr_alloc_fourcc(uint16_t ubuf_pool_depth, uint16_t shared_pool_depth, struct umem_mgr *umem_mgr, const char *fcc, int hmprepend, int hmappend, int vprepend, int vappend, int align, int align_hmoffset)

Upipe ubuf manager for picture formats with umem storage

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

This function is declared in upipe/ubuf_pic_mem.h source file, line 86.

This function adds a new plane to a ubuf manager for picture formats using umem. It may only be called on initializing the manager, before any ubuf is allocated.

Parameters list:

• mgr: pointer to a ubuf_mgr structure
• chroma: chroma type (see chroma reference)
• hsub: horizontal subsamping
• vsub: vertical subsamping
• macropixel_size: size of a macropixel in octets

The return value is an error code

This function is declared in upipe/ubuf_pic_mem.h source file, line 71.

This function allocates a new instance of the ubuf manager for picture formats using umem.

Parameters list:

• ubuf_pool_depth: maximum number of ubuf structures in the pool
• shared_pool_depth: maximum number of shared structures in the pool
• umem_mgr: memory allocator to use for buffers
• macropixel: number of pixels in a macropixel (typically 1)
• hprepend: extra pixels added before each line (if set to -1, a default sensible value is used)
• happend: extra pixels added after each line (if set to -1, a default sensible value is used)
• vprepend: extra lines added before buffer (if set to -1, a default sensible value is used)
• vappend: extra lines added after buffer (if set to -1, a default sensible value is used)
• align: alignment in octets (if set to 0, no line will be voluntarily aligned)
• align_hmoffset: horizontal offset of the aligned macropixel in a line (may be negative)

The return value is pointer to manager, or NULL in case of error

This function is declared in upipe/ubuf_pic_mem.h source file, line 115.

This function allocates a new instance of the ubuf manager for picture formats using umem, from a fourcc image format.

Parameters list:

• ubuf_pool_depth: maximum number of ubuf structures in the pool
• shared_pool_depth: maximum number of shared structures in the pool
• umem_mgr: memory allocator to use for buffers
• fcc: fourcc to use to create the manager
• hmprepend: extra macropixels added before each line (if set to -1, a default sensible value is used)
• hmappend: extra macropixels added after each line (if set to -1, a default sensible value is used)
• vprepend: extra lines added before buffer (if set to -1, a default sensible value is used)
• vappend: extra lines added after buffer (if set to -1, a default sensible value is used)
• align: alignment in octets (if set to 0, no line will be voluntarily aligned)
• align_hmoffset: horizontal offset of the aligned macropixel in a line (may be negative)

The return value is pointer to manager, or NULL in case of error