dmIC(3dm)                                                            dmIC(3dm)



NAME
     dmICGetNum, dmICGetDescription - find out about available image
     converters

SYNOPSIS
     #include <dmedia/dmimageconvert.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:

     DMICID     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 DMICID

     DMICENGINE 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.

     DMICSPEED  Use dmParamsGetEnum to return one of the following values of
                  this parameter:
                  DMICSPEEDREALTIME     suitable for real time performance
                  DMICSPEEDNONREALTIME  not suitable for real time performance
                  DMICSPEEDUNDEFINED    speed undefined

     DMICCODEDIRECTION
                  Use dmParamsGetEnum to return one of the following values of
                  this parameter:
                  DMICCODEDIRECTIONENCODE   encode converter
                  DMICCODEDIRECTIONDECODE   decode converter
                  DMICCODEDIRECTIONUNDEFINEDcode direction undefined

     DMICVERSION
                  Use dmParamsGetInt to return the version of the image
                  converter.

     DMICREVISION
                  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