*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> dmedia/dmicchoose (3d)              


dmIC(3dm)							     dmIC(3dm)

NAME    [Toc]    [Back]

     dmICChooseConverter - return an image converter that matches specified
     image parameters

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/dm_imageconvert.h>

     int dmICChooseConverter(DMparams* src, DMparams *dst, DMparams *conv);

DESCRIPTION    [Toc]    [Back]

     dmICChooseConverter returns the index of an image converter which
     performs the conversion of	image data described by	src to that described
     by	dst using the conversion control parameters in conv. The number
     returned is for use in dmICGetDescription and dmICCreate.

     If	no converter could be found, -1	will be	returned and an	error will be
     set (see dmSetError(3dm)).

     If	the function succeeds, src, dst	and conv can then be used in
     dmICSetSrcParams, dmICSetDstParams	and dmICSetConvParams respectively.

     In	order for dmICChooseConverter to work correctly, src, dst and conv
     must be set with their respective required	parameters.  In	addition, one
     of	the following requirements must	be met.

     DM_IC_ID and DM_IC_CODE_DIRECTION set in conv    [Toc]    [Back]
	  In this case,	the converter with the matching	ID and code direction
	  that satisfies the requirements in src, dst and conv is chosen.

     DM_IMAGE_COMPRESSION set in src and dst    [Toc]    [Back]
	  In this case,	the converter that matches the compression
	  requirements in src, dst and conv will be chosen.

     Currently there is	no provision for choosing a realtime over a nonrealtime
 converter	, and vice-versa . Extra code needs to be written to
     do	so. The	following code fragment	shows how to to	find a realtime	JPEG

     DMimageconverter ic;
     DMparams *p;
     int n = dmICGetNum();
     while (n--) {
	     if	(dmICGetDescription(n, p) == DM_SUCCESS
		     dmParamsGetInt(p, DM_IC_ID) == 'jpeg' &&
		     dmParamsGetEnum(p,	DM_IC_SPEED) ==	DM_IC_SPEED_REALTIME &&
		     dmParamsGetEnum(p,	DM_IC_CODE_DIRECTION) ==

									Page 1

dmIC(3dm)							     dmIC(3dm)

     dmICCreate(n, &ic);

SEE ALSO    [Toc]    [Back]

     dmICCreate(3dm), dmICSetSrcParams(3dm), dmICSetDstParams(3dm),
     dmICSetConvParams(3dm), dmParams(3dm), dmSetImageDefaults(3dm),

									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
dmicdst IRIX manipulate image converter context dst image format
dmicsrc IRIX manipulate image converter context src image format
dmicreceive IRIX transfer output from the image converter
dmicqueue IRIX image converter queue management
dmicsend IRIX transfer input to the image converter context
dmicwork IRIX call the image converter and have it perform a task
dmicpool IRIX get the input/output buffering needs of the image converter
dmicopen IRIX create and destroy image converter context
dmicconv IRIX manipulate conversion controls of an image converter context
XmInstallImage HP-UX A pixmap caching function that adds an image to the image cache
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service