opensolaris man page for mlib_videosumabsdiff

mlib_VideoSumAbsDiff(3MLIB)				    mediaLib Library Functions				       mlib_VideoSumAbsDiff(3MLIB)

NAME
       mlib_VideoSumAbsDiff - motion estimation

SYNOPSIS
       cc [ flag... ] file... -lmlib [ library... ]
       #include <mlib.h>

       mlib_s32 mlib_VideoSumAbsDiff(mlib_u8 *curr_block,
	    const mlib_u8 *ref_block, mlib_s32 width, mlib_s32 height,
	    mlib_s32 stride);

DESCRIPTION
       The  mlib_VideoSumAbsDiff() function computes the sum of absolute differences between the pixels in the current block and the corresponding
       pixels in the reference block.

       Both the current block and the reference block belong to frames with the same dimension. (The stride is applicable to both.) Motion estima-
       tion  computes  the  sum of the absolute differences between the current block and reference blocks at different locations in the reference
       frame, choosing the best fit (least sum of absolute difference) to calculate the motion vector.

PARAMETERS
       The function takes the following arguments:

       curr_block    Pointer to the current block. curr_block must be 8-byte aligned.

       ref_block     Pointer to the reference block.

       width	     Width of the block.

       height	     Height of the block.

       stride	     Stride, in bytes, between adjacent rows in a block. stride must be a multiple of eight.

RETURN VALUES
       The function returns a value of type mlib_s32.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Committed 		   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       attributes(5)

SunOS 5.11							    2 Mar 2007					       mlib_VideoSumAbsDiff(3MLIB)