/*

* Copyright (c) 2010 Ixonos Plc.

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of the "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - Initial contribution

*

* Contributors:

* Ixonos Plc

*

* Description:  

* Header file for block handling functions.

*

*/

#ifndef __BLKFUNC_H

#define __BLKFUNC_H

#include "epoclib.h"

// General-purpose clip tables for signed and unsigned chars.

// Both of these tables range from -2048 to +2047.

extern const u_char unsignedCharClip[];

extern const char signedCharClip[]; // MH

/*

 *

 * blcAddBlock

 *

 * Parameters:

 *    block                block array

 *    frame_p              pointer to present frame in the place,

 *                         where the block is added

 *    xSize                X size of the frame.

 *    mbPlace              flag that indicates the place for the current

 *                         macroblock inside the macroblock row:

 *                            -1 beginning of row

 *                             0 middle of row

 *                             1 end of row

 *    fourMVs              1 if Advanced Prediction Mode is used, otherwise 0

 *    prevDiffBlock        if fourMVs == 1 and mbPlace <= 0 the difference

 *                         block is stored to prevDiffBlock for later use

 *

 * Function:

 *    This function sums the given block into block being currently decoded in

 *    present frame. Parameters are the table consisting a block, a pointer to

 *    the frame at the correct place and the width of the frame.

 *

 * Returns:

 *    Nothing.

 *

 * Error codes:

 *    None.

 *

 */

void __cdecl blcAddBlockAsm(int *block, u_char *frame_p, int xSize,

   int mbPlace, u_char fourMVs, int *prevDiffBlock);

/*

 *

 * blcMixBlocks

 *

 * Parameters:

 *    dest        Destination pointer

 *    src         Source pointer

 *    yn          Y size of the block

 *    xn          X size of the block (0-16)

 *    ydiff       X line length of the destination block

 *    sydiff      X line length of the source block

 *

 * Function:

 *    This function replaces all the pixels in the destination block with

 *    an average calculated from the corresponding source and destination

 *    block pixels.

 *

 * Returns:

 *    Nothing.

 *

 * Error codes:

 *    None.

 *

 */

void __cdecl blcMixBlocks( u_char *dest, u_char *src, int yn, int xn,

   int ydiff, int sydiff );

/*

 *

 * blcMixOverlapped

 *

 * Parameters:

 *    blkBuf      Source blocks:

 *                64b whole, 32b left, 32b right, 32b up, 32b down

 *    dest        Destination pointer

 *    ddelta      Delta for destination lines

 *

 * Function:

 *    Calculates weighted averages of several macroblock pieces - see

 *    function blcOverlappedMC in block.c for more detailed description.

 *

 * Returns:

 *    Nothing.

 *

 * Error codes:

 *    None.

 *

 */

void __cdecl blcMixOverlapped( u_char *blkBuf, u_char *dest, int ddelta );

/*

 *

 * blcInvQuant

 *

 * Parameters:

 *    block       Block pointer

 *    quant       Quantization value

 *    count       Number of values to process

 *

 * Function:

 *    Does inverse quantization for a block for idct.

 *

 * Returns:

 *    Nothing.

 *

 * Error codes:

 *    None.

 *

 */

void __cdecl blcInvQuant( int *block, int quant, int count );

#endif

// End of File