icetsingleimagestrategy(3) [debian man page]
icetSingleImageStrategy(3) IceT Reference icetSingleImageStrategy(3) NAME
icetSingleImageStrategy -- set the sub-strategy used to composite the image for a single tile. Synopsis #include <IceT.h> void icetSingleImageStrategy( IceTEnum strategy ); Description The main IceT algorithms are specially designed to composite data defined on multiple tiles. Some of these algorithms, namely ICET_STRAT- EGY_REDUCE and ICET_STRATEGY_SEQUENTIAL, operate at least in part by compositing single images together. IceT also comes with multiple sep- arate strategies for performing this single image compositing, and this can be selected with the icetSingleImageStrategy function. A single image strategy is chosen from one of the following provided enumerated values: ICET_SINGLE_IMAGE_STRATEGY_AUTOMATIC Automatically chooses which single image strategy to use based on the number of processes participating in the composition. ICET_SINGLE_IMAGE_STRATEGY_BSWAP The classic binary swap compositing algorithm. At each phase of the algorithm, each process partners with another, sends half of its image to its partner, and receives the opposite half from its partner. The processes are then partitioned into two groups that each have the same image part, and the algorithm recurses. ICET_SINGLE_IMAGE_STRATEGY_RADIXK The radix-k acompositing algorithm is similar to binary swap except that groups of processes can be larger than two. Larger groups require more overall messages but overlap blending and communication. The size of the groups is indirectly controlled by the ICET_MAGIC_K environment variable or CMake variable. ICET_SINGLE_IMAGE_STRATEGY_TREE At each phase, each process partners with another, and one of the processes sends its entire image to the other. The algorithm recurses with the group of processes that received images until only one process has an image. By default IceT sets the single image strategy to ICET_SINGLE_IMAGE_STRATEGY_AUTOMATIC when a context is created. This is the single image strategy that will be used if no other is selected. Errors ICET_INVALID_ENUM The strategy argument does not represent a valid single image strategy. 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 icetDrawFrame(3), icetGetStrategyName(3) icetSingleImageStrategy(3) IceT Reference August 9, 2010 icetSingleImageStrategy(3)
Check Out this Related Man Page
icetSetColorFormat(3) IceT Reference icetSetColorFormat(3) NAME
icetSetColorFormat,icetSetDepthFormat-- specifies the buffer formats for IceT to use when creating images Synopsis #include <IceT.h> void icetSetColorFormat( IceTEnum color_format ); void icetSetDepthFormat( IceTEnum depth_format ); Description When IceT creates image objects, it uses the formats specified by icetSetColorFormatand icetSetDepthFormat.These will be the formats of images passed to drawing callbacks (specified by icetDrawCallback or icetGLDrawCallback) and of images returned from frame drawing func- tions (icetDrawFrame or icetGLDrawFrame). The following color_formats are valid for use in icetSetColorFormat. ICET_IMAGE_COLOR_RGBA_UBYTE Each entry is an RGBA color tuple. Each component is valued in the range from 0 to 255 and is stored as an 8-bit integer. The buf- fer will always be allocated on memory boundaries such that each color value can be treated as a single 32-bit integer. ICET_IMAGE_COLOR_RGBA_FLOAT Each entry is an RGBA color tuple. Each component is in the range from 0.0 to 1.0 and is stored as a 32-bit float. ICET_IMAGE_COLOR_NONE No color values are stored in the image. The following depth_formats are valid for use in icetSetDepthFormat. ICET_IMAGE_DEPTH_FLOAT Each entry is in the range from 0.0 (near plane) to 1.0 (far plane) and is stored as a 32-bit float. ICET_IMAGE_DEPTH_NONE No depth values are stored in the image. The color and depth formats are stored in the ICET_COLOR_FORMAT and ICET_DEPTH_FORMAT state variables, respectively. Errors ICET_INVALID_OPERATION icetSetColorFormator icetSetDepthFormatwas called while IceT was drawing a frame. This probably means that you called icetSetColor- Format in a drawing callback. You cannot do that. Call this function before starting the draw operation. ICET_INVALID_ENUM The color_format or depth_format given is invalid. Warnings None. Bugs None known. Notes Calling either icetSetColorFormator icetSetDepthFormatdoes not change the format of any existing images. It only changes any subsequently created images. The color format must be set before calling either icetDrawFrame or icetGLDrawFrame. Doing otherwise would create inconsistencies in the images created and composed together. 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 icetImageGetColorFormat(3), icetImageGetDepthFormat(3) IceT Reference August 9, 2010 icetSetColorFormat(3)