diff --git a/gst-libs/gst/video/video-format.h b/gst-libs/gst/video/video-format.h index 748a958e4783e16d7a7b31a39d858af956eafa34..e2a7d78994304f8a6c0aeee41fca916d58c0700e 100644 --- a/gst-libs/gst/video/video-format.h +++ b/gst-libs/gst/video/video-format.h @@ -253,9 +253,14 @@ typedef enum * @width: the amount of pixels to unpack. * * Unpacks @width pixels from the given planes and strides containing data of - * format @info. The pixels will be unpacked into @dest which each component - * interleaved. @dest should at least be big enough to hold @width * - * n_components * size(unpack_format) bytes. + * format @info. The pixels will be unpacked into @dest with each component + * interleaved as per @info's unpack_format, which will usually be one of + * #GST_VIDEO_FORMAT_ARGB, #GST_VIDEO_FORMAT_AYUV, #GST_VIDEO_FORMAT_ARGB64 or + * #GST_VIDEO_FORMAT_AYUV64 depending on the format to unpack. + * @dest should at least be big enough to hold @width * bytes_per_pixel bytes + * where bytes_per_pixel relates to the unpack format and will usually be + * either 4 or 8 depending on the unpack format. bytes_per_pixel will be + * the same as the pixel stride for plane 0 for the above formats. * * For subsampled formats, the components will be duplicated in the destination * array. Reconstruction of the missing components can be performed in a