diff options
author | Anton Khirnov <anton@khirnov.net> | 2016-06-25 14:48:47 +0200 |
---|---|---|
committer | Anton Khirnov <anton@khirnov.net> | 2016-06-28 08:30:59 +0200 |
commit | 5fcae3b3f93fd02b3d1e009b9d9b17410fca9498 (patch) | |
tree | e1c52cde0849bfec8c2926d74f915cad6728c90e | |
parent | 94ebf5565849e4dc036d2ca43979571ed3736457 (diff) | |
download | ffmpeg-streaming-5fcae3b3f93fd02b3d1e009b9d9b17410fca9498.zip ffmpeg-streaming-5fcae3b3f93fd02b3d1e009b9d9b17410fca9498.tar.gz |
hwcontext: clarify the behaviour of transfer_data() for cropped frames
-rw-r--r-- | libavutil/hwcontext.h | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/libavutil/hwcontext.h b/libavutil/hwcontext.h index f15cf7c..0b12fe2 100644 --- a/libavutil/hwcontext.h +++ b/libavutil/hwcontext.h @@ -318,6 +318,14 @@ int av_hwframe_get_buffer(AVBufferRef *hwframe_ctx, AVFrame *frame, int flags); * If dst->format is set, then this format will be used, otherwise (when * dst->format is AV_PIX_FMT_NONE) the first acceptable format will be chosen. * + * The two frames must have matching allocated dimensions (i.e. equal to + * AVHWFramesContext.width/height), since not all device types support + * transferring a sub-rectangle of the whole surface. The display dimensions + * (i.e. AVFrame.width/height) may be smaller than the allocated dimensions, but + * also have to be equal for both frames. When the display dimensions are + * smaller than the allocated dimensions, the content of the padding in the + * destination frame is unspecified. + * * @param dst the destination frame. dst is not touched on failure. * @param src the source frame. * @param flags currently unused, should be set to zero |