icetcopystate(3) [debian man page]
icetCopyState(3) IceT Reference icetCopyState(3) NAME
icetCopyState -- copy state machine of one context to another. Synopsis #include <IceT.h> void icetCopyState( IceTContext dest, const IceTContext src ); Description The icetCopyState function replaces the state of dest with the current state of src. This function can be used to quickly duplicate a con- text. The IceTCommunicator object associated with dest is not changed (nor can it ever be). Consequently, the following state values are not copied either, since they refer to process ids that are directly tied to the IceTCommunicator object: ICET_RANK, ICET_NUM_PROCESSES, ICET_DATA_REPLICATION_GROUP, ICET_DATA_REPLICATION_GROUP_SIZE, ICET_COMPOSITE_ORDER, and ICET_PROCESS_ORDERS. However, every other state parameter is copied. Errors None. Warnings None. Bugs The state is copied blindly. It is therefore possible to copy states that are invalid for a context's communicator. For example, a display rank may not refer to a valid process id. Notes Behavior is undefined if dest or src has never been created or has already been destroyed. Copyright Copyright (C)2003 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 icetCreateContext(3), icetGetContext(3), icetSetContext(3) IceT Reference August 9, 2010 icetCopyState(3)
Check Out this Related Man Page
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)