GSMFR

Encodes audio data streams in the PCM format into the GSMFR format.

The function is called as follows:

Obtain the size of the memory to be applied for encoding (dstBufLen).
Initialize the structure by calling an initialization function.
Call the main function HMPPA_Gsmfr_Encode_16s8u for encoding.
Call Release to release the memory allocated in the structure.

The function interface declaration is as follows:

Obtaining the size of the memory to be applied for encoding:
HmppResult HMPPA_Gsmfr_GetEncodeDstBufLen_16s8u(int32_t len, int32_t *dstBufLen);
Initialization:
HmppResult HMPPA_Gsmfr_EncodeInit_16s8u(HmppaGsmefrEncodePolicy_16s **policy);
Encoding:
HmppResult HMPPA_Gsmfr_Encode_16s8u(const int16_t *src, int32_t len, uint8_t *dst, HmppaGsmfrEncodePolicy_16s *policy, int64_t *bytesConsumed, int32_t *bytesEncoded);
Release:
HmppResult HMPPA_Gsmfr_EncodeRelease_16s8u(HmppaGsmfrEncodePolicy_16s *policy);

Parameters

Parameter	Description	Value Range	Input/Output
src	Pointer to the GSMFR stream to be encoded	The value cannot be NULL.	Input
len	Length of the data stream to be encoded (in dual-bytes)	(0, INT_MAX]	Input
dst	Pointer to the destination vector	The value cannot be NULL.	Output
policy	Pointer to the special structure	The value cannot be NULL.	Input/Output
bytesConsumed	Pointer to the data stream length (in bytes) actually consumed for encoding	[0, len]	Output
bytesDecoded	Pointer to the data stream length (in bytes) of the actual encoded output	[0, Theoretical output data stream length after encoding]	Output
dstBufLen	Length (in bytes) required to point to the destination vector	The value cannot be NULL.	Output

Return Value

Success: HMPP_STS_NO_ERR
Failure: An error code is returned.

Error Code

Error Code	Description
HMPP_STS_NULL_PTR_ERR	The value of src, dst, or policy is NULL.
HMPP_STS_MALLOC_FAILED	Memory allocation failed.
HMPP_STS_SIZE_WRN	The input data stream is not completely encoded.

Example

#include <stdio.h>
#include <stdlib.h>
#include <stdint.h>
#include <string.h>
#include <hmpp.h>

int main(int argc, char *argv[]) 
{
    if (argc < 3) {
        fprintf(stderr, "%s in.amr out.wav\n", argv[0]);
        return 1;
    }

    FILE *in = fopen(argv[1], "r");
    FILE *out = fopen(argv[2], "w+");
    if (!in || !out) {
        printf("Open file failed!\n");
        return 1;
    }

    fseek(in, 0, SEEK_END);
    int32_t srcLen = ftell(in) / 2;
    fseek(in, 0, SEEK_SET);

    HmppaGsmfrEncodePolicy_16s *policy;
    int32_t re = HMPPA_Gsmfr_EncodeInit_16s8u(&policy, 0);
    int16_t *src = (int16_t*)malloc(srcLen * sizeof(int16_t));

    int dstLen;
    re = HMPPA_Gsmfr_GetEncodeDstBufLen_16s8u(srcLen, &dstLen);
    uint8_t *dst = (uint8_t*)malloc(dstLen * sizeof(uint8_t));
    fread(src, sizeof(int16_t), srcLen, in);

    int64_t bytesConsumed = 0;
    int32_t bytesDecoded = 0;
    re = HMPPA_Gsmfr_Encode_16s8u(src, srcLen, dst, policy, &bytesConsumed, &bytesDecoded);
    printf("HmppResult:%d, bytesConsumed:%d, bytesDecoded:%d\n", re, bytesConsumed, bytesDecoded);

    re = HMPPA_Gsmfr_EncodeRelease_16s8u(policy);
    fwrite(dst, sizeof(uint8_t), dstLen, out);

    fclose(in);
    fclose(out);

    return 0;
}

Output:

HmppResult:0, bytesConsumed:50560, bytesDecoded:5214

Parent topic: Audio Encoding