dmParamsGetInt(3dm)					   dmParamsGetInt(3dm)

NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #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    [Toc]    [Back]

     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.







									Page 1






dmParamsGetInt(3dm)					   dmParamsGetInt(3dm)

SEE ALSO    [Toc]    [Back]

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


									PPPPaaaaggggeeee 2222