AVPicture
[Core functions/structures.]

Functions for working with AVPicture. More...

Data Structures
struct	AVPicture
	four components are given, that's all. More...
Functions
int	avpicture_alloc (AVPicture *picture, enum PixelFormat pix_fmt, int width, int height)
	Allocate memory for a picture.
void	avpicture_free (AVPicture *picture)
	Free a picture previously allocated by avpicture_alloc().
int	avpicture_fill (AVPicture *picture, uint8_t *ptr, enum PixelFormat pix_fmt, int width, int height)
	Fill in the AVPicture fields, always assume a linesize alignment of 1.
int	avpicture_layout (const AVPicture *src, enum PixelFormat pix_fmt, int width, int height, unsigned char *dest, int dest_size)
	Copy pixel data from an AVPicture into a buffer, always assume a linesize alignment of 1.
int	avpicture_get_size (enum PixelFormat pix_fmt, int width, int height)
	Calculate the size in bytes that a picture of the given width and height would occupy if stored in the given picture format.
int	avpicture_deinterlace (AVPicture *dst, const AVPicture *src, enum PixelFormat pix_fmt, int width, int height)
	deinterlace - if not supported return -1
void	av_picture_copy (AVPicture *dst, const AVPicture *src, enum PixelFormat pix_fmt, int width, int height)
	Copy image src to dst.
int	av_picture_crop (AVPicture *dst, const AVPicture *src, enum PixelFormat pix_fmt, int top_band, int left_band)
	Crop image top and left side.
int	av_picture_pad (AVPicture *dst, const AVPicture *src, int height, int width, enum PixelFormat pix_fmt, int padtop, int padbottom, int padleft, int padright, int *color)
	Pad image.

---

Detailed Description

Functions for working with AVPicture.

---

Function Documentation

void av_picture_copy	(	AVPicture *	dst,
		const AVPicture *	src,
		enum PixelFormat	pix_fmt,
		int	width,
		int	height
	)

Copy image src to dst.

Wraps av_image_copy().

Definition at line 607 of file imgconvert.c.

Referenced by avcodec_default_reget_buffer(), copy_frame(), qtrle_encode_frame(), queue_picture(), and roq_decode_frame().

int av_picture_crop	(	AVPicture *	dst,
		const AVPicture *	src,
		enum PixelFormat	pix_fmt,
		int	top_band,
		int	left_band
	)

Crop image top and left side.

Definition at line 742 of file imgconvert.c.

int av_picture_pad	(	AVPicture *	dst,
		const AVPicture *	src,
		int	height,
		int	width,
		enum PixelFormat	pix_fmt,
		int	padtop,
		int	padbottom,
		int	padleft,
		int	padright,
		int *	color
	)

Pad image.

Definition at line 772 of file imgconvert.c.

int avpicture_alloc	(	AVPicture *	picture,
		enum PixelFormat	pix_fmt,
		int	width,
		int	height
	)

Allocate memory for a picture.

Call avpicture_free() to free it.

See also:

avpicture_fill()

Parameters:

	picture	the picture to be filled in
	pix_fmt	the format of the picture
	width	the width of the picture
	height	the height of the picture

Returns:

zero if successful, a negative value if not

Definition at line 701 of file imgconvert.c.

Referenced by ff_create_schro_frame(), open_video(), and qtrle_encode_init().

int avpicture_deinterlace	(	AVPicture *	dst,
		const AVPicture *	src,
		enum PixelFormat	pix_fmt,
		int	width,
		int	height
	)

deinterlace - if not supported return -1

Definition at line 940 of file imgconvert.c.

Referenced by pre_process_video_frame().

int avpicture_fill	(	AVPicture *	picture,
		uint8_t *	ptr,
		enum PixelFormat	pix_fmt,
		int	width,
		int	height
	)

Fill in the AVPicture fields, always assume a linesize alignment of 1.

See also:

av_image_fill_arrays()

Definition at line 403 of file imgconvert.c.

Referenced by copy_frame(), do_streamcopy(), pre_process_video_frame(), raw_decode(), and sdl_write_packet().

void avpicture_free

(

AVPicture *

picture

)

Free a picture previously allocated by avpicture_alloc().

The data buffer used by the AVPicture is freed, but the AVPicture structure itself is not.

Parameters:

picture

the AVPicture to be freed

Definition at line 714 of file imgconvert.c.

Referenced by free_schro_frame(), and qtrle_encode_end().

int avpicture_get_size	(	enum PixelFormat	pix_fmt,
		int	width,
		int	height
	)

Calculate the size in bytes that a picture of the given width and height would occupy if stored in the given picture format.

Always assume a linesize alignment of 1.

See also:

av_image_get_buffer_size().

Definition at line 418 of file imgconvert.c.

Referenced by dc1394_read_common(), encode_frame(), lavfi_read_packet(), libschroedinger_encode_init(), pnm_encode_frame(), pnm_parse(), pre_process_video_frame(), raw_encode(), raw_init_decoder(), rawvideo_read_packet(), targa_encode_frame(), utvideo_decode_init(), utvideo_encode_init(), v4l2_read_header(), vble_decode_init(), yuv4_read_packet(), and zerocodec_decode_init().

int avpicture_layout	(	const AVPicture *	src,
		enum PixelFormat	pix_fmt,
		int	width,
		int	height,
		unsigned char *	dest,
		int	dest_size
	)

Copy pixel data from an AVPicture into a buffer, always assume a linesize alignment of 1.

See also:

av_image_copy_to_buffer()

Definition at line 410 of file imgconvert.c.

Referenced by encode_frame(), lavfi_read_packet(), libschroedinger_frame_from_data(), and raw_encode().