frame: add a convenience function for copying AVFrame data

1 files changed, 13 insertions, 0 deletions

diff --git a/libavutil/frame.h b/libavutil/frame.h
index 20766423f5..30cc1e47c9 100644
--- a/libavutil/frame.h
+++ b/libavutil/frame.h
@@ -506,6 +506,19 @@ int av_frame_is_writable(AVFrame *frame);
 int av_frame_make_writable(AVFrame *frame);
 
 /**
+ * Copy the frame data from src to dst.
+ *
+ * This function does not allocate anything, dst must be already initialized and
+ * allocated with the same parameters as src.
+ *
+ * This function only copies the frame data (i.e. the contents of the data /
+ * extended data arrays), not any other properties.
+ *
+ * @return >= 0 on success, a negative AVERROR on error.
+ */
+int av_frame_copy(AVFrame *dst, const AVFrame *src);
+
+/**
  * Copy only "metadata" fields from src to dst.
  *
  * Metadata for the purpose of this function are those fields that do not affect