dmIC(3dm)dmIC(3dm)NAME
dmICGetNum, dmICGetDescription - find out about available image
converters
SYNOPSIS
#include <dmedia/dm_imageconvert.h>
int dmICGetNum(void);
DMstatus dmICGetDescription(int i, DMparams *converterParams);
DESCRIPTIONdmICGetNum returns the number of image converters available.This value
may change from invocations to invocations, depending upon whether any
image converters has been added or removed from the system since its last
invocation.
dmICGetDescription returns the description of the indicated converter.
The value of the i argument ranges from 0 to one less than the value
returned by dmICGetNum. The description consists of the values of the
following DMparams parameters:
DM_IC_ID Use dmParamsGetInt to return 4 character value of this
parameter. This 4 character code is a unique to an
algorithm in the system. For example, all converters that
uses the jpeg algorithm has the 4 character code DM_IC_ID
DM_IC_ENGINE Use dmParamsGetString to return the character string value
of this parameter. This string is an english description
that describes the engine name used for this particular
conversion algorithm.
DM_IC_SPEED Use dmParamsGetEnum to return one of the following values of
this parameter:
DM_IC_SPEED_REALTIME suitable for real time performance
DM_IC_SPEED_NONREALTIME not suitable for real time performance
DM_IC_SPEED_UNDEFINED speed undefined
DM_IC_CODE_DIRECTION
Use dmParamsGetEnum to return one of the following values of
this parameter:
DM_IC_CODE_DIRECTION_ENCODE encode converter
DM_IC_CODE_DIRECTION_DECODE decode converter
DM_IC_CODE_DIRECTION_UNDEFINEDcode direction undefined
DM_IC_VERSION
Use dmParamsGetInt to return the version of the image
converter.
DM_IC_REVISION
Use dmParamsGetInt to return the revision of the image
converter.
Page 1
dmIC(3dm)dmIC(3dm)SEE ALSOdmICChooseConverter(3dm), dmICCreate(3dm), dmParams(3dm).
Page 2
