wiki:

Debug

/

MacroblocksAndMotionVectors


Version 4 (modified by slhck, 4 years ago) (diff)

explain MB types briefly

Debugging Macroblocks and Motion Vectors

You can use ffmpeg or ffplay to analyze the macroblocks / coding tree units and motion vectors in a video file.

Analyzing Macroblock Types

You need to specify the -debug vis_mb_type option. For example:

ffplay -debug vis_mb_type input.mp4
ffmpeg -debug vis_mb_type -i input.mp4 output.mp4

The output would look something like this:

In the output video, each macroblock will be colored according to its type. Additionally, you can see the macroblock partitions as small lines. The following table lists the possible colors and the associated macroblock types. Note that these are parsed in order (from top to bottom), and if one condition matches, the color will be chosen.

Color Macroblock Type Condition Explanation
IS_PCM (MB_TYPE_INTRA_PCM) Lossless (raw samples without prediction)
(IS_INTRA && IS_ACPRED) || IS_INTRA16x16 16x16 Intra prediction
IS_INTRA4x4 4x4 Intra prediction
IS_DIRECT No motion vectors are sent (B slices)
IS_GMC && IS_SKIP 16x16 Skip macroblock (P or B slices)
IS_GMC Global motion compensation (not relevant for H.264)
!USES_LIST(1) Reference to past (List 0, P or B slices)
!USES_LIST(0) Reference to future (List 1, B slices)
USES_LIST(0) && USES_LIST(1) Reference to past and future (List 1 & 2, B slices)

Note that the decoding of macroblock types is MPEG-specific, so this option will not work for VP8 video, for example.

Analyzing Motion Vectors

The -vismv option can be used to show motion vectors as small arrows for each macroblock. It takes one parameter, which specifies the type of motion vector to be drawn:

  • -vismv pf – forward predicted motion vectors of P pictures
  • -vismv bf – forward predicted motion vectors of B pictures
  • -vismv bb – backward predicted motion vectors of B pictures

For example, you can use:

ffplay -vismv pf input.mp4
ffmpeg -vismv pf -i input.mp4 output.mp4

Example:

Attachments (12)

Download all attachments as: .zip