AddC
Adds a constant to each element of a vector.
The function interface is declared as follows:
- Operations on floating-point numbers:
HmppResult HMPPS_AddC_32f(const float *src, float val, float *dst, int32_t len);
HmppResult HMPPS_AddC_64f(const double *src, double val, double *dst, int32_t len);
HmppResult HMPPS_AddC_32fc(const Hmpp32fc *src, Hmpp32fc val, Hmpp32fc *dst, int32_t len);
HmppResult HMPPS_AddC_64fc(const Hmpp64fc *src, Hmpp64fc val, Hmpp64fc *dst, int32_t len);
- Operations on integers with scaling:
HmppResult HMPPS_AddC_8u_S(const uint8_t *src, uint8_t val, uint8_t *dst, int32_t len, double scale);
HmppResult HMPPS_AddC_16u_S(const uint16_t *src, uint16_t val, uint16_t *dst, int32_t len, double scale);
HmppResult HMPPS_AddC_16s_S(const int16_t *src, int16_t val, int16_t *dst, int32_t len, double scale);
HmppResult HMPPS_AddC_32s_S(const int32_t *src, int32_t val, int32_t *dst, int32_t len, double scale);
HmppResult HMPPS_AddC_64s_S(const int64_t *src, int64_t val, int64_t *dst, int32_t len, double scale, HmppRoundMode rndMode);
HmppResult HMPPS_AddC_16sc_S(const Hmpp16sc *src, Hmpp16sc val, Hmpp16sc *dst, int32_t len, double scale);
HmppResult HMPPS_AddC_32sc_S(const Hmpp32sc *src, Hmpp32sc val, Hmpp32sc *dst, int32_t len, double scale);
HmppResult HMPPS_AddC_64u_S(const uint64_t *src, uint64_t val, uint64_t *dst, int32_t len, double scale, HmppRoundMode rndMode);
- In-place operations on integers:
HmppResult HMPPS_AddC_16s_I(int16_t val, int16_t *srcDst, int32_t len);
- In-place operations on floating-point numbers:
HmppResult HMPPS_AddC_32f_I(float val, float *srcDst, int32_t len);
HmppResult HMPPS_AddC_64f_I(double val, double *srcDst, int32_t len);
HmppResult HMPPS_AddC_32fc_I(Hmpp32fc val, Hmpp32fc *srcDst, int32_t len);
HmppResult HMPPS_AddC_64fc_I(Hmpp64fc val, Hmpp64fc *srcDst, int32_t len);
- In-place operations on integers with scaling:
HmppResult HMPPS_AddC_8u_IS(uint8_t val, uint8_t *srcDst, int32_t len, double scale);
HmppResult HMPPS_AddC_16u_IS(uint16_t val, uint16_t_t *srcDst, int32_t len, double scale);
HmppResult HMPPS_AddC_16s_IS(int16_t val, int16_t *srcDst, int32_t len, double scale);
HmppResult HMPPS_AddC_32s_IS(int32_t val, int32_t *srcDst, int32_t len, double scale);
HmppResult HMPPS_AddC_16sc_IS(Hmpp16sc val, Hmpp16sc *srcDst, int32_t len, double scale);
HmppResult HMPPS_AddC_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 |
Fixed value |
Not limited, depending on the data 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 = 2n, where n is an integer. The value is within (0, INF). |
Input |
rndMode |
Round mode (defined in the HmppRoundMode enumeration type. See Enumeration Types.) |
The value is an element of HmppRoundMode:
|
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 AddCExample(void)
{
uint8_t src[BUFFER_SIZE_T] = {0, 1, 3, 5, 7, 10, 254, 255, 20, 50};
uint8_t dst[BUFFER_SIZE_T] = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
uint8_t val = 1;
double scale = 2.0;
int32_t i;
HmppResult result = HMPPS_AddC_8u_S(src, val, dst, BUFFER_SIZE_T, scale);
printf("result = %d \n", result);
if (result != HMPP_STS_NO_ERR) {
return;
}
printf("dst =");
for (i = 0; i < BUFFER_SIZE_T; i++) {
printf(" %d ", dst[i]);
}
printf("\n");
}
Output:
result = 0 dst = 0 1 2 3 4 6 128 128 10 26