Ienc

Provides a simple interface to IMGENC (XDM 0.9) based algorithms. More...

Typedefs

typedef struct Ienc_Object * Ienc_Handle
 Handle through which to reference an Image Encode algorithm.

Functions

Ienc_Handle Ienc_create (Engine_Handle hEngine, Char *codecName, IMGENC_Params *params, IMGENC_DynamicParams *dynParams)
 Creates an Image Encode (XDM 0.9) algorithm instance.
Int Ienc_process (Ienc_Handle hIe, Buffer_Handle hInBuf, Buffer_Handle hOutBuf)
 Encodes an image buffer.
Int Ienc_delete (Ienc_Handle hIe)
 Deletes an Image Encode algorithm instance.
IMGENC_Handle Ienc_getVisaHandle (Ienc_Handle hIe)
 Get the IMGENC handle from the Ienc module instance.
Int32 Ienc_getInBufSize (Ienc_Handle hIe)
 Get the input buffer size required by the codec.
Int32 Ienc_getOutBufSize (Ienc_Handle hIe)
 Get the output buffer size required by the codec.

Variables

const IMGENC_Params Ienc_Params_DEFAULT
 Default XDM parameters for an Image Encode algorithm.
const IMGENC_DynamicParams Ienc_DynamicParams_DEFAULT
 Default XDM dynamic parameters for an Image Encode algorithm.

Detailed Description

Provides a simple interface to IMGENC (XDM 0.9) based algorithms.


Typedef Documentation

typedef struct Ienc_Object* Ienc_Handle

Handle through which to reference an Image Encode algorithm.


Function Documentation

Ienc_Handle Ienc_create ( Engine_Handle  hEngine,
Char *  codecName,
IMGENC_Params *  params,
IMGENC_DynamicParams *  dynParams 
)

Creates an Image Encode (XDM 0.9) algorithm instance.

Parameters:
[in] hEngine An opened engine containing the algorithm to create.
[in] codecName The name of the algorithm to open. Corresponds to the string name given in the .cfg file.
[in] params XDM parameters to use while creating the codec.
[in] dynParams XDM dynamic parameters to use while creating the codec.
Return values:
Handle for use in subsequent operations (see Ienc_Handle).
NULL for failure.

Int Ienc_process ( Ienc_Handle  hIe,
Buffer_Handle  hInBuf,
Buffer_Handle  hOutBuf 
)

Encodes an image buffer.

Parameters:
[in] hIe The Ienc_Handle to use for encoding.
[in] hInBuf The Buffer_Handle for the buffer containing the raw data.
[in] hOutBuf The Buffer_Handle for the buffer to fill with encoded data.
Return values:
Dmai_EOK for success.
Negative value for failure, see Dmai.h.
Remarks:
Ienc_create must be called before this function.

Int Ienc_delete ( Ienc_Handle  hIe  ) 

Deletes an Image Encode algorithm instance.

Parameters:
[in] hIe The Ienc_Handle to delete.
Return values:
Dmai_EOK for success.
Negative value for failure, see Dmai.h.
Remarks:
Ienc_create must be called before this function.

IMGENC_Handle Ienc_getVisaHandle ( Ienc_Handle  hIe  ) 

Get the IMGENC handle from the Ienc module instance.

Parameters:
[in] hIe The Ienc_Handle for which to get the IMGENC handle.
Return values:
Handle to the image encode algorithm, see the XDM documentation for IMGENC.
Remarks:
Ienc_create must be called before this function.

Int32 Ienc_getInBufSize ( Ienc_Handle  hIe  ) 

Get the input buffer size required by the codec.

Parameters:
[in] hIe The Ienc_Handle for which to get the buffer size.
Return values:
Size in bytes of the input buffer required.
Remarks:
Ienc_create must be called before this function.

Int32 Ienc_getOutBufSize ( Ienc_Handle  hIe  ) 

Get the output buffer size required by the codec.

Parameters:
[in] hIe The Ienc_Handle for which to get the buffer size.
Return values:
Size in bytes of the output buffer required.
Remarks:
Ienc_create must be called before this function.


Variable Documentation

const IMGENC_Params Ienc_Params_DEFAULT

Default XDM parameters for an Image Encode algorithm.

     size                     = sizeof (IMGENC_Params),
     maxHeight                = 0,
     maxWidth                 = 0,
     maxScans                 = XDM_DEFAULT, 
     dataEndianness           = XDM_LE_32,
     forceChromaFormat        = XDM_YUV_422P

const IMGENC_DynamicParams Ienc_DynamicParams_DEFAULT

Default XDM dynamic parameters for an Image Encode algorithm.

  size                        = sizeof(IMGENC_DynamicParams),
  numAU                       = XDM_DEFAULT,
  inputChromaFormat           = XDM_YUV_422ILE,
  inputHeight                 = 0, 
  inputWidth                  = 0,
  captureWidth                = 0,
  generateHeader              = XDM_ENCODE_AU,
  qValue                            = 75


Copyright 2011, Texas Instruments Incorporated