MulC

Multiplies a vector by a constant.

The function interface declaration is as follows:

Operations on floating-point numbers with scaling:
HmppResult HMPPS_MulC_32f(const float *src, float val, float *dst, int32_t len);

HmppResult HMPPS_MulC_64f(const double *src, double val, double*dst, int32_t len);

HmppResult HMPPS_MulC_32fc(const Hmpp32fc *src, Hmpp32fc val, Hmpp32fc *dst, int32_t len);

HmppResult HMPPS_MulC_64fc(const Hmpp64fc *src, Hmpp64fc val, Hmpp64fc *dst, int32_t len);

HmppResult HMPPS_MulC_Low_32f16s(const float *src, float val, int16_t *dst, int32_t len);

Operations on integers with scaling:
HmppResult HMPPS_MulC_8u_S(const uint8_t *src, uint8_t val, uint8_t *dst, int32_t len, double scale);

HmppResult HMPPS_MulC_16u_S(const uint16_t *src, uint16_t val, uint16_t *dst, int32_t len, double scale);

HmppResult HMPPS_MulC_16s_S(const int16_t *src, int16_t val, int16_t *dst, int32_t len, double scale);

HmppResult HMPPS_MulC_32s_S(const int32_t *src, int32_t val, int32_t *dst, int32_t len, double scale);

HmppResult HMPPS_MulC_32f16s_S(const float *src, float val, int16_t *dst, int32_t len, double scale);

HmppResult HMPPS_MulC_16sc_S(const Hmpp16sc *src, Hmpp16sc val, Hmpp16sc *dst, int32_t len, double scale);

HmppResult HMPPS_MulC_32sc_S(const Hmpp32sc *src, Hmpp32sc val, Hmpp32sc *dst, int32_t len, double scale);

In-place operations on integers:
HmppResult HMPPS_MulC_8u_IS(uint8_t val, uint8_t *srcDst, int32_t len, double scale);

HmppResult HMPPS_MulC_16u_IS(uint16_t val, uint16_t *srcDst, int32_t len, double scale);

In-place operations on floating-point numbers:
HmppResult HMPPS_MulC_16s_I(int16_t val, int16_t *srcDst, int32_t len);

HmppResult HMPPS_MulC_32f_I(float val, float *srcDst, int32_t len);

HmppResult HMPPS_MulC_64f_I(double val, double *srcDst, int32_t len);

HmppResult HMPPS_MulC_32fc_I(Hmpp32fc val, Hmpp32fc *srcDst, int32_t len);

HmppResult HMPPS_MulC_64fc_I(Hmpp64fc val, Hmpp64fc *srcDst, int32_t len);

In-place operations on integers with scaling:
HmppResult HMPPS_MulC_16s_IS(int16_t val, int16_t *srcDst, int32_t len, double scale);

HmppResult HMPPS_MulC_32s_IS(int32_t val, int32_t *srcDst, int32_t len, double scale);

HmppResult HMPPS_MulC_64s_IS(int64_t val, int64_t *srcDst, int32_t len, double scale);

HmppResult HMPPS_MulC_64f64s_IS(double val, int64_t *srcDst, int32_t len, double scale);

HmppResult HMPPS_MulC_16sc_IS(Hmpp16sc val, Hmpp16sc *srcDst, int32_t len, double scale);

HmppResult HMPPS_MulC_32sc_IS(Hmpp32sc val, Hmpp32sc *srcDst, int32_t len, double scale);

Parameters

Parameter	Description	Value Range	Input/Output
src	Pointer to the source vector	The value cannot be NULL.	Input
val	Constant	Not limited, depending on the type	Input
dst	Pointer to the destination vector	The value cannot be NULL.	Output
srcDst	Pointer to the source vector for in-place operations	The value cannot be NULL.	Input/Output
len	Vector length	(0, INT_MAX]	Input
scale	Scale factor	scale = 2ⁿ, where n is an integer. The value is within (0, INF).	Input

Return Value

Success: HMPP_STS_NO_ERR
Failure: An error code is returned.

Error Codes

Error Code	Description
HMPP_STS_NULL_PTR_ERR	The value of src, dst, or srcDst is NULL.
HMPP_STS_SIZE_ERR	The value of len is less than or equal to 0.
HMPP_STS_SCALE_ERR	The value of scale is not within the range (0, INF) or is NaN.

Example

#define BUFFER_SIZE_T 10

void MulCExample(void)
{
    uint8_t srcDst[BUFFER_SIZE_T] = {255, 0, 254, 0, 253, 1, 252, 2, 251, 3};
    uint8_t val = 54;
    HmppResult result = HMPPS_MulC_8u_IS(val, srcDst, BUFFER_SIZE_T, 8.0);
    printf("result = %d\n", result);
    if (result != HMPP_STS_NO_ERR) {
        return;
    }
    printf("srcDst =");
    for (int i = 0; i < BUFFER_SIZE_T; i++) {
        printf(" %d", srcDst[i]);
    }
    printf("\n");
}

Output:

result = 0
srcDst = 255 0 255 0 255 7 255 14 255 20

Parent topic: Basic and Common Calculations