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);

DESCRIPTION
     dmICGetNum 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 ALSO
     dmICChooseConverter(3dm), dmICCreate(3dm), dmParams(3dm).





















































                                                                        Page 2