icetgetsingleimagestrategyname(3) [debian man page]

icetGetSingleImageStrategyName(3)				  IceT Reference				 icetGetSingleImageStrategyName(3)

NAME

       icetGetSingleImageStrategyName -- retrieve single image sub-strategy name.

Synopsis
       #include <IceT.h>

       const char *icetGetSingleImageStrategyName(   void   );

Description
       icetGetSingleImageStrategyName retrieves a human-readable name for the current single image sub-strategy.

Return Value
       Returns	a  short,  null terminated string identifying the single image strategy currently in effect. Helpful for printing out debugging or
       diagnostic statements.

Errors
       None.

Warnings
       None.

Bugs
       None known.

Notes
       The string returned does not contain the identifier used in a C program. For example, if the current single  image  strategy  is  ICET_SIN-
       GLE_IMAGE_STRATEGY_BSWAP, icetGetSingleImageStrategyName returns ``Binary Swap,'' not ``ICET_SINGLE_IMAGE_STRATEGY_BSWAP.''

Copyright
       Copyright (C)2010 Sandia Corporation

       Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government retains certain rights in this software.

       This source code is released under the New BSD License.

See Also
       icetGetStrategyName(3), icetSingleImageStrategy(3)

IceT Reference							  August 23, 2010				 icetGetSingleImageStrategyName(3)

icetImageNull(3)						  IceT Reference						  icetImageNull(3)

NAME

       icetImageNull -- retrieve a placeholder for an empty image.

Synopsis
       #include <IceT.h>

       IceTImage icetImageNull(   void	 );

Description
       Images  are  created internally by the IceT library. Sometimes it is convenient to have a placeholder for a .igimage!null``null'' image, an
       image that does not and cannot hold data. Null images require no allocated memory to function.

       If your code has the potential of using an IceTImage image object that might not otherwise be initialized, use icetImageNull to set it to a
       null object. This will ensure that IceT image functions that operate on it will behave deterministically.

       A  null	image simply looks like an image with no pixels and has no color buffers. icetImageGetWidth, icetImageGetHeight, and icetImageGet-
       NumPixels all return 0 for a null image.  icetSetColorFormatand icetSetDepthFormatreturn ICET_IMAGE_COLOR_NONE  and  ICET_IMAGE_DEPTH_NONE,
       respectively.

       You can identify a null image with the icetImageIsNull function.

Return Value
       A null image object.

Errors
       None.

Warnings
       None.

Bugs
       None known.

Copyright
       Copyright (C)2010 Sandia Corporation

       Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government retains certain rights in this software.

       This source code is released under the New BSD License.

See Also
       icetImageIsNull(3)

IceT Reference							September 20, 2010						  icetImageNull(3)