imgconvert.c File Reference

misc image conversion routines More...

#include "avcodec.h"
#include "dsputil.h"
#include "internal.h"
#include "imgconvert.h"
#include "libavutil/colorspace.h"
#include "libavutil/pixdesc.h"
#include "libavutil/imgutils.h"

Go to the source code of this file.

Data Structures

struct  PixFmtInfo

Macros

#define FF_COLOR_RGB   0
 RGB color space.
#define FF_COLOR_GRAY   1
 gray color space
#define FF_COLOR_YUV   2
 YUV color space.
#define FF_COLOR_YUV_JPEG   3
 YUV color space.
#define FF_PIXEL_PLANAR   0
 each channel has one component in AVPicture
#define FF_PIXEL_PACKED   1
 only one components containing all the channels
#define FF_PIXEL_PALETTE   2
 one components containing indexes for a palette
#define deinterlace_line_inplace   deinterlace_line_inplace_c
#define deinterlace_line   deinterlace_line_c

Typedefs

typedef struct PixFmtInfo PixFmtInfo

Functions

void avcodec_get_chroma_sub_sample (enum PixelFormat pix_fmt, int *h_shift, int *v_shift)
int ff_is_hwaccel_pix_fmt (enum PixelFormat pix_fmt)
 Determine whether pix_fmt is a hardware accelerated format.
int avpicture_fill (AVPicture *picture, uint8_t *ptr, enum PixelFormat pix_fmt, int width, int height)
 Fill in the AVPicture fields.
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.
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 avcodec_get_pix_fmt_loss (enum PixelFormat dst_pix_fmt, enum PixelFormat src_pix_fmt, int has_alpha)
 Compute what kind of losses will occur when converting from one specific pixel format to another.
static int avg_bits_per_pixel (enum PixelFormat pix_fmt)
static enum PixelFormat avcodec_find_best_pix_fmt1 (int64_t pix_fmt_mask, enum PixelFormat src_pix_fmt, int has_alpha, int loss_mask)
enum PixelFormat avcodec_find_best_pix_fmt (int64_t pix_fmt_mask, enum PixelFormat src_pix_fmt, int has_alpha, int *loss_ptr)
 Find the best pixel format to convert to given a certain source pixel format.
void av_picture_copy (AVPicture *dst, const AVPicture *src, enum PixelFormat pix_fmt, int width, int height)
 Copy image src to dst.
void ff_shrink22 (uint8_t *dst, int dst_wrap, const uint8_t *src, int src_wrap, int width, int height)
void ff_shrink44 (uint8_t *dst, int dst_wrap, const uint8_t *src, int src_wrap, int width, int height)
void ff_shrink88 (uint8_t *dst, int dst_wrap, const uint8_t *src, int src_wrap, int width, int height)
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().
static int is_yuv_planar (const PixFmtInfo *ps)
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.
static void deinterlace_line_c (uint8_t *dst, const uint8_t *lum_m4, const uint8_t *lum_m3, const uint8_t *lum_m2, const uint8_t *lum_m1, const uint8_t *lum, int size)
static void deinterlace_line_inplace_c (uint8_t *lum_m4, uint8_t *lum_m3, uint8_t *lum_m2, uint8_t *lum_m1, uint8_t *lum, int size)
static void deinterlace_bottom_field (uint8_t *dst, int dst_wrap, const uint8_t *src1, int src_wrap, int width, int height)
static void deinterlace_bottom_field_inplace (uint8_t *src1, int src_wrap, int width, int height)
int avpicture_deinterlace (AVPicture *dst, const AVPicture *src, enum PixelFormat pix_fmt, int width, int height)

Variables

static const PixFmtInfo pix_fmt_info [PIX_FMT_NB]

Detailed Description

misc image conversion routines

Definition in file imgconvert.c.

Macro Definition Documentation

#define deinterlace_line   deinterlace_line_c

Definition at line 59 of file imgconvert.c.

Referenced by deinterlace_bottom_field().

#define deinterlace_line_inplace   deinterlace_line_inplace_c

Definition at line 58 of file imgconvert.c.

Referenced by deinterlace_bottom_field_inplace().

#define FF_COLOR_GRAY   1

gray color space

Definition at line 46 of file imgconvert.c.

Referenced by avcodec_get_pix_fmt_loss().

#define FF_COLOR_RGB   0

RGB color space.

Definition at line 45 of file imgconvert.c.

Referenced by avcodec_get_pix_fmt_loss().

#define FF_COLOR_YUV   2

YUV color space.

16 <= Y <= 235, 16 <= U, V <= 240

Definition at line 47 of file imgconvert.c.

Referenced by avcodec_get_pix_fmt_loss(), and is_yuv_planar().

#define FF_COLOR_YUV_JPEG   3

YUV color space.

0 <= Y <= 255, 0 <= U, V <= 255

Definition at line 48 of file imgconvert.c.

Referenced by avcodec_get_pix_fmt_loss(), and is_yuv_planar().

#define FF_PIXEL_PACKED   1

only one components containing all the channels

Definition at line 51 of file imgconvert.c.

Referenced by avg_bits_per_pixel().

#define FF_PIXEL_PALETTE   2

one components containing indexes for a palette

Definition at line 52 of file imgconvert.c.

Referenced by avcodec_get_pix_fmt_loss(), and avg_bits_per_pixel().

#define FF_PIXEL_PLANAR   0

each channel has one component in AVPicture

Definition at line 50 of file imgconvert.c.

Referenced by avg_bits_per_pixel(), and is_yuv_planar().

Typedef Documentation

typedef struct PixFmtInfo PixFmtInfo

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_picture_data_copy() above.

Definition at line 664 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 784 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 806 of file imgconvert.c.

enum PixelFormat avcodec_find_best_pix_fmt ( int64_t  pix_fmt_mask,
enum PixelFormat  src_pix_fmt,
int  has_alpha,
int *  loss_ptr 
)

Find the best pixel format to convert to given a certain source pixel format.

When converting from one pixel format to another, information loss may occur. For example, when converting from RGB24 to GRAY, the color information will be lost. Similarly, other losses occur when converting from some formats to other formats. avcodec_find_best_pix_fmt() searches which of the given pixel formats should be used to suffer the least amount of loss. The pixel formats from which it chooses one, are determined by the pix_fmt_mask parameter.

src_pix_fmt = PIX_FMT_YUV420P;
pix_fmt_mask = (1 << PIX_FMT_YUV422P) || (1 << PIX_FMT_RGB24);
dst_pix_fmt = avcodec_find_best_pix_fmt(pix_fmt_mask, src_pix_fmt, alpha, &loss);
Parameters
[in]pix_fmt_maskbitmask determining which pixel format to choose from
[in]src_pix_fmtsource pixel format
[in]has_alphaWhether the source pixel format alpha channel is used.
[out]loss_ptrCombination of flags informing you what kind of losses will occur.
Returns
The best pixel format to convert to or -1 if none was found.

Definition at line 631 of file imgconvert.c.

static enum PixelFormat avcodec_find_best_pix_fmt1 ( int64_t  pix_fmt_mask,
enum PixelFormat  src_pix_fmt,
int  has_alpha,
int  loss_mask 
)
static

Definition at line 604 of file imgconvert.c.

Referenced by avcodec_find_best_pix_fmt().

void avcodec_get_chroma_sub_sample ( enum PixelFormat  pix_fmt,
int *  h_shift,
int *  v_shift 
)
int avcodec_get_pix_fmt_loss ( enum PixelFormat  dst_pix_fmt,
enum PixelFormat  src_pix_fmt,
int  has_alpha 
)

Compute what kind of losses will occur when converting from one specific pixel format to another.

When converting from one pixel format to another, information loss may occur. For example, when converting from RGB24 to GRAY, the color information will be lost. Similarly, other losses occur when converting from some formats to other formats. These losses can involve loss of chroma, but also loss of resolution, loss of color depth, loss due to the color space conversion, loss of the alpha bits or loss due to color quantization. avcodec_get_fix_fmt_loss() informs you about the various types of losses which will occur when converting from one pixel format to another.

Parameters
[in]dst_pix_fmtdestination pixel format
[in]src_pix_fmtsource pixel format
[in]has_alphaWhether the source pixel format alpha channel is used.
Returns
Combination of flags informing you what kind of losses will occur.

Definition at line 493 of file imgconvert.c.

Referenced by avcodec_find_best_pix_fmt(), and avcodec_find_best_pix_fmt1().

static int avg_bits_per_pixel ( enum PixelFormat  pix_fmt)
static

Definition at line 552 of file imgconvert.c.

Referenced by avcodec_find_best_pix_fmt1().

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
picturethe picture to be filled in
pix_fmtthe format of the picture
widththe width of the picture
heightthe height of the picture
Returns
zero if successful, a negative value if not

Definition at line 758 of file imgconvert.c.

Referenced by ff_create_schro_frame(), libschroedinger_handle_first_access_unit(), qtrle_encode_init(), transcode(), and transcode_init().

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

Definition at line 1023 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.

The fields of the given AVPicture are filled in by using the 'ptr' address which points to the image data buffer. Depending on the specified picture format, one or multiple image data pointers and line sizes will be set. If a planar format is specified, several pointers will be set pointing to the different picture planes and the line sizes of the different planes will be stored in the lines_sizes array. Call with ptr == NULL to get the required size for the ptr buffer.

To allocate the buffer and fill in the AVPicture fields in one call, use avpicture_alloc().

Parameters
pictureAVPicture whose fields are to be filled in
ptrBuffer which will contain or contains the actual image data
pix_fmtThe format in which the picture data is stored.
widththe width of the image in pixels
heightthe height of the image in pixels
Returns
size of the image data in bytes

Definition at line 429 of file imgconvert.c.

Referenced by alloc_picture(), avpicture_get_size(), copy_frame(), libdirac_decode_frame(), libschroedinger_decode_frame(), pre_process_video_frame(), and raw_decode().

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
picturethe AVPicture to be freed

Definition at line 771 of file imgconvert.c.

Referenced by FreeSchroFrame(), libschroedinger_decode_close(), 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.

Note that this returns the size of a compact representation as generated by avpicture_layout(), which can be smaller than the size required for e.g. avpicture_fill().

Parameters
pix_fmtthe given picture format
widththe width of the image
heightthe height of the image
Returns
Image data size in bytes or -1 on error (e.g. too large dimensions).

Definition at line 476 of file imgconvert.c.

Referenced by alloc_picture(), avpicture_layout(), dc1394_read_common(), libdirac_decode_frame(), libdirac_encode_init(), libschroedinger_encode_init(), pam_encode_frame(), pnm_encode_frame(), pnm_parse(), pre_process_video_frame(), raw_init_decoder(), rawvideo_read_packet(), targa_encode_frame(), v4l2_read_header(), vble_decode_init(), and yuv4_read_packet().

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.

The data is stored compactly, without any gaps for alignment or padding which may be applied by avpicture_fill().

See Also
avpicture_get_size()
Parameters
[in]srcAVPicture containing image data
[in]pix_fmtThe format in which the picture data is stored.
[in]widththe width of the image in pixels.
[in]heightthe height of the image in pixels.
[out]destA buffer into which picture data will be copied.
[in]dest_sizeThe size of 'dest'.
Returns
The number of bytes written to dest, or a negative value (error code) on error.

Definition at line 443 of file imgconvert.c.

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

static void deinterlace_bottom_field ( uint8_t *  dst,
int  dst_wrap,
const uint8_t *  src1,
int  src_wrap,
int  width,
int  height 
)
static

Definition at line 969 of file imgconvert.c.

Referenced by avpicture_deinterlace().

static void deinterlace_bottom_field_inplace ( uint8_t *  src1,
int  src_wrap,
int  width,
int  height 
)
static

Definition at line 998 of file imgconvert.c.

Referenced by avpicture_deinterlace().

static void deinterlace_line_c ( uint8_t *  dst,
const uint8_t *  lum_m4,
const uint8_t *  lum_m3,
const uint8_t *  lum_m2,
const uint8_t *  lum_m1,
const uint8_t *  lum,
int  size 
)
static

Definition at line 917 of file imgconvert.c.

static void deinterlace_line_inplace_c ( uint8_t *  lum_m4,
uint8_t *  lum_m3,
uint8_t *  lum_m2,
uint8_t *  lum_m1,
uint8_t *  lum,
int  size 
)
static

Definition at line 942 of file imgconvert.c.

int ff_is_hwaccel_pix_fmt ( enum PixelFormat  pix_fmt)

Determine whether pix_fmt is a hardware accelerated format.

Definition at line 424 of file imgconvert.c.

Referenced by avcodec_default_get_format().

void ff_shrink22 ( uint8_t *  dst,
int  dst_wrap,
const uint8_t *  src,
int  src_wrap,
int  width,
int  height 
)

Definition at line 672 of file imgconvert.c.

Referenced by dsputil_init().

void ff_shrink44 ( uint8_t *  dst,
int  dst_wrap,
const uint8_t *  src,
int  src_wrap,
int  width,
int  height 
)

Definition at line 705 of file imgconvert.c.

Referenced by dsputil_init().

void ff_shrink88 ( uint8_t *  dst,
int  dst_wrap,
const uint8_t *  src,
int  src_wrap,
int  width,
int  height 
)

Definition at line 736 of file imgconvert.c.

Referenced by dsputil_init().

static int is_yuv_planar ( const PixFmtInfo ps)
inlinestatic

Definition at line 777 of file imgconvert.c.

Referenced by av_picture_crop(), and av_picture_pad().

Variable Documentation

const PixFmtInfo pix_fmt_info[PIX_FMT_NB]
static

Definition at line 71 of file imgconvert.c.