iflDataSize(3)	  Image	Format Library C++ Reference Manual	iflDataSize(3)

NAME    [Toc]    [Back]

     iflDataClosestType, iflDataIsIntegral, iflDataIsSigned, iflDataMax,
     iflDataMin, iflDataSize, iflDataTypeFromRange - convenience functions for
     using IFL data types

SYNOPSIS    [Toc]    [Back]

     #include <ifl/iflDataSize.h>


	  iflDataType iflDataClosestType(iflDataType desired,
					 int allowed, int flags=0)
	  int iflDataIsIntegral(iflDataType type)
	  int iflDataIsSigned(iflDataType type)
	  double iflDataMax(iflDataType	type)
	  double iflDataMin(iflDataType	type)
	  int iflDataSize(iflDataType type, int	count=1)
	  iflDataType iflDataTypeFromRange(double minVal, double maxVal)

DESCRIPTION    [Toc]    [Back]

     These functions operate on	IFL data types and are provided	for
     convenience.  Each	function is standalone and is not a member function of
     any object.

     The data types used in the	IFL are	specified by the enumerated type,
     iflType, as defined in <ifl/iflTypes.h>. The following IFL	data types are
     valid:  iflBit, iflUChar, iflChar,	iflUShort, iflShort, iflUInt, iflInt,
     iflFloat, iflDouble.

     iflDataClosestType() returns the data type	closest	to the desired type in
     the set specified by the mask of data types in allowed. The flags
     parameter is the logical or of any	of the folowing	options:

	  iflDataWantSigned   consider only signed types from allowed (unless
			      there aren't any,	then fall back on unsigned
			      values)

	  iflDataAnySign      consider both signed and unsigned	types.	The
			      default behaviour	is to consider types that
			      match the	signed/unsigned	nature of desired.

	  iflDataDemote	      don't allow type promotion; only consider	types
			      of the same size of smaller.

     iflDataIsIntegral returns TRUE if type is an integral valued IFL type. If
     type is a floating	point IFL type,	then FALSE is returned.

     iflDataIsSigned() returns TRUE if type is a signed	IFL type. If type is
     an	unsigned IFL type, then	FALSE is returned.






									Page 1






iflDataSize(3)	  Image	Format Library C++ Reference Manual	iflDataSize(3)



     iflDataMax() returns the maximum value possible for the given data	type,
     type.

     iflDataMin() returns the minimum value possible for the given IFL data
     type, type.

     iflDataSize() returns the size in bytes required to hold the number of
     values specified by count,	of the given data type,	type.

     iflDataTypeFromRange() returns the	IFL data type required to hold the
     range of values specified by minVal and maxVal.

SEE ALSO    [Toc]    [Back]

     ifl/iflTypes.h


									PPPPaaaaggggeeee 2222