dmParamsGetInt(3dm)                                        dmParamsGetInt(3dm)


NAME
     dmParamsGetInt, dmParamsGetEnum, dmParamsGetString, dmParamsGetBinary,
     dmParamsGetFloat, dmParamsGetFract, dmParamsGetParams - get values from
     digital media parameter/value lists

SYNOPSIS
     #include <dmedia/dm_params.h>

     int dmParamsGetInt
           ( const DMparams* params,
             const char* paramName )

     int dmParamsGetEnum
           ( const DMparams* params,
             const char* paramName )

     const char* dmParamsGetString
           ( const DMparams* params,
             const char* paramName )

     const void* dmParamsGetBinary
           ( const DMparams* params,
             const char* paramName,
             size_t* dataSize )

     double dmParamsGetFloat
           ( const DMparams* params,
             const char* paramName )

     DMfraction dmParamsGetFract
           ( const DMparams* params,
             const char* paramName )

     const DMparams* dmParamsGetParams
           ( const DMparams* params,
             const char* paramName )

DESCRIPTION
     These functions all retrieve values stored in a parameter/value list.
     They assume that the named parameter is present and is of the specified
     type; the debugging version of the library asserts that this is the case.
     The value, or a pointer to it is returned.  For strings, binary data,
     parameter lists, and table-of-contents entries, the pointer returned
     points into the internal data structure of the parameter list.  It should
     never be freed, and is only guaranteed to remain valid until the next
     time the list is changed.  In general, if you need to keep a string or
     binary-stream value around after getting it from a parameter/value list,
     it should be copied.


SEE ALSO
     dmParams(3dm), dmParamsSetInt(3dm), dmParamsGetNumElems(3dm),
     dmSetImageDefaults(3dm), dmSetAudioDefaults(3dm).


                                                                        Page 2