icetcompositemode(3) [debian man page]
icetCompositeMode(3) IceT Reference icetCompositeMode(3) NAME
icetCompositeMode -- set the type of operation used for compositing Synopsis #include <IceT.h> void icetCompositeMode( IceTEnum mode ); Description Sets the composite mode used when combining images. IceT enables parallel rendering by allowing each process in your code to independently render images of partial geometry. These partial-geometry images are then ``composited'' to form a single image equivalent to if all the geometry were rendered by a single process. IceT supports multiple operations that can be used to combine images. The operator you use should be equivalent to that used by your ren- dering system to resolve .ighidden surfacehidden surfaces or mix occluding geometry with that behind it. The argument mode is one of the following enumerations: ICET_COMPOSITE_MODE_Z_BUFFER Use the .igz-bufferz-buffer hidden-surface removal operation. The compositing operation compares the distance of pixel fragments from the viewpoint and passes the fragment closest to the user. In order for this operation to work, images must have a depth buffer (set with icetSetDepthFormat). ICET_COMPOSITE_MODE_BLEND Blend two fragments together using the standard .igover operator.igunder operatorover/under operator. in order for this operation to work, images must have a color buffer (set with icetSetColorFormat)that has an alpha channel and there must be no depth buffer (as the operation makes no sense with depth). Also, this mode will only work if ICET_ORDERED_COMPOSITE is enabled and the order is set with icetCompositeOrder. The default compositing mode is ICET_COMPOSITE_MODE_Z_BUFFER. The current composite mode is stored in the ICET_COMPOSITE_MODE state vari- able. Errors ICET_INVALID_ENUM mode is not a valid composite mode. Warnings None. Bugs icetCompositeMode will let you set a mode even if it is incompatible with other current settings. Some settings will be checked during a call to icetDrawFrame. For example, if the image format (specified with icetSetColorFormatand icetSetDepthFormat)does not support the com- posite mode picked, you will get an error during the call to icetDrawFrame. Other incompatibilities are also not checked. For example, if the composite mode is set to ICET_COMPOSITE_MODE_BLEND, IceT will happily use this operator even if ICET_ORDERED_COMPOSITE is not enabled. However, because order matters in the blend mode, you will probably get incor- rect images if the compositing happens in arbitrary order. 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 icetCompositeOrder(3), icetSetColorFormat(3), icetSetDepthFormat(3) IceT Reference August 9, 2010 icetCompositeMode(3)
Check Out this Related Man Page
icetStrategy(3) IceT Reference icetStrategy(3) NAME
icetStrategy -- set the strategy used to composite images. Synopsis #include <IceT.h> void icetStrategy( IceTEnum strategy ); Description The IceT API comes packaged with several algorithms for compositing images. The algorithm to use is determined by selecting a strategy. The strategy is selected with icetStrategy. A strategy must be selected before icetDrawFrame is called. A strategy is chosen from one of the following provided enumerated values: ICET_STRATEGY_SEQUENTIAL Basically applies a ``traditional'' single tile composition (such as binary swap) to each tile in the order they were defined. Because each process must take part in the composition of each tile regardless of whether they draw into it, this strategy is usu- ally inefficient when compositing for more than one tile, but is recommended for the single tile case because it bypasses some of the communication necessary for the other multi-tile strategies. ICET_STRATEGY_DIRECT As each process renders an image for a tile, that image is sent directly to the process that will display that tile. This usually results in a few processes receiving and processing the majority of the data, and is therefore usually an inefficient strategy. ICET_STRATEGY_SPLIT Like ICET_STRATEGY_DIRECT, except that the tiles are split up, and each process is assigned a piece of a tile in such a way that each process receives and handles about the same amount of data. This strategy is often very efficient, but due to the large amount of messages passed, it has not proven to be very scalable or robust. ICET_STRATEGY_REDUCE A two phase algorithm. In the first phase, tile images are redistributed such that each process has one image for one tile. In the second phase, a ``traditional'' single tile composition is performed for each tile. Since each process contains an image for only one tile, all these compositions may happen simultaneously. This is a well rounded strategy that seems to perform well in a wide variety of multi-tile applications. (However, in the special case where only one tile is defined, the sequential strategy is proba- bly better.) ICET_STRATEGY_VTREE An extension to the binary tree algorithm for image composition. Sets up a ``virtual'' composition tree for each tile image. Pro- cesses that belong to multiple trees (because they render to more than one tile) are allowed to float between trees. This strategy is not quite as well load balanced as ICET_STRATEGY_REDUCE or ICET_STRATEGY_SPLIT, but has very well behaved network communication. Not all of the strategies support ordered image composition. ICET_STRATEGY_SEQUENTIAL, ICET_STRATEGY_DIRECT, and ICET_STRATEGY_REDUCE do support ordered image composition. ICET_STRATEGY_SPLIT and ICET_STRATEGY_VTREE do not support ordered image composition and will ignore ICET_ORDERED_COMPOSITE if it is enabled. Some of the strategies, namely ICET_STRATEGY_SEQUENTIAL and ICET_STRATEGY_REDUCE, use a sub-strategy that composites the image for a single tile. This single image strategy can also be specified with icetSingleImageStrategy. Errors ICET_INVALID_ENUM The strategy argument does not represent a valid strategy. Warnings None. Bugs None known. 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 icetDrawFrame(3), icetGetStrategyName(3) icetSingleImageStrategy(3) IceT Reference August 9, 2010 icetStrategy(3)