VXLIB_accumulateWeightedImage_i8u_io8u


Detailed Description


Functions

VXLIB_STATUS VXLIB_accumulateWeightedImage_i8u_io8u (const uint8_t src[restrict], const VXLIB_bufParams2D_t *src_addr, uint8_t dst[restrict], const VXLIB_bufParams2D_t *dst_addr, VXLIB_F32 alpha)
VXLIB_STATUS VXLIB_accumulateWeightedImage_i8u_io8u_checkParams (const uint8_t src[], const VXLIB_bufParams2D_t *src_addr, const uint8_t dst[], const VXLIB_bufParams2D_t *dst_addr, VXLIB_F32 alpha)


Function Documentation

VXLIB_STATUS VXLIB_accumulateWeightedImage_i8u_io8u ( const uint8_t  src[restrict],
const VXLIB_bufParams2D_t src_addr,
uint8_t  dst[restrict],
const VXLIB_bufParams2D_t dst_addr,
VXLIB_F32  alpha 
)

Description:
Accumulates a weighted value from an input image to an output image.
Method:
Weighted accumulation is computed by:

    dst(x,y) = (1alpha)*dst(x,y) + alpha*src(x,y)

   

Parameters:
[in] src[] Pointer to array containing first input image (UQ8.0)
[in] src_addr[] Pointer to structure containing dimensional information of src
[in,out] dst[] Pointer to array containing output image (UQ8.0)
[in] dst_addr[] Pointer to structure containing dimensional information of dst
[in] alpha Parameter indicating weight for src and dst (0.0 <= alpha <= 1.0)
Assumptions:
  • I/O buffer pointers are assumed to be not aliased.
Performance Considerations:
  • For best performance, the following parameter settings are recommended:
    • Set widths equal to strides
    • Align all pointers to 8 byte boundaries
    • Set all stride values to a multiple of 8
    • Set all width values to a multiple of 8

VXLIB_STATUS VXLIB_accumulateWeightedImage_i8u_io8u_checkParams ( const uint8_t  src[],
const VXLIB_bufParams2D_t src_addr,
const uint8_t  dst[],
const VXLIB_bufParams2D_t dst_addr,
VXLIB_F32  alpha 
)

Description:
Checks the parameters for programming errors for the VXLIB_accumulateImage_i8u_io16s function.
Method:
The following checks are made:
  • There shall be no NULL pointers
  • All images shall have the same x and y dimensions
  • The strides of each image shall be equal to or greater than the x dimension
  • The alpha parameter shall be (0.0 <= alpha <= 1.0)
Parameters:
[in] src[] Pointer to array containing first input image (UQ8.0)
[in] src_addr[] Pointer to structure containing dimensional information of src
[in,out] dst[] Pointer to array containing output image (UQ8.0)
[in] dst_addr[] Pointer to structure containing dimensional information of dst
[in] alpha Parameter indicating weight for src and dst (0.0 <= alpha <= 1.0)


Copyright 2020, Texas Instruments Incorporated