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
icetEnable(3) IceT Reference icetEnable(3) NAME
icetEnable,icetDisable-- enable/disable an IceT feature. Synopsis #include <IceT.h> void icetEnable ( IceTEnum pname ); void icetDisable ( IceTEnum pname ); Description The icetEnableand icetDisablefunctions turn various IceT features on and off. pname is a symbolic constant representing the feature to be turned on or off. Valid values for pname are: ICET_COLLECT_IMAGES When this option is on (the default) images partitions are always collected to display processes. When this option is turned off, the strategy has the option of leaving images partitioned among processes. Each process containing part of a tile's image will return the entire buffer from icetDrawFrame or icetGLDrawFrame in an IceTImage object. However, only certain pixels will be valid. The state variables ICET_VALID_PIXELS_TILE, ICET_VALID_PIXELS_OFFSET, and ICET_VALID_PIXELS_NUM give which tile the pixels belong to and what range of pixels are valid. ICET_COMPOSITE_ONE_BUFFER Turn this option on when performing z-buffer compositing of a color image and the only result you need is the color image itself (not the depth buffer). This is common if you are just creating an image and are not interested in doing depth queries. This option is on by default. ICET_CORRECT_COLORED_BACKGROUND Colored backgrounds are problematic when performing color blended compositing in that the background color will be additively blended from each image. Enabling this flag will internally cause the color to be reset to black and then cause the color to be blended back into the resulting images. This flag is disabled by default. ICET_FLOATING_VIEWPORT If enabled, the projection will be shifted such that the geometry will be rendered in one shot whenever possible, even if the geom- etry straddles up to four tiles. This flag is enabled by default. ICET_INTERLACE_IMAGES If enabled, pixels in images (might be) shuffled to better load balance the compositing work. This flag is enabled by default. ICET_ORDERED_COMPOSITE If enabled, the image composition will be performed in the order specified by the last call to icetCompositeOrder, assuming the current strategy (specified by a call to icetStrategy) supports ordered composition. Generally, you want to enable ordered com- positing if doing color blending and disable if you are doing z-buffer comparisons. If enabled, you should call icetCompositeOrder between each frame to update the image order as camera angles change. This flag is disabled by default. In addition, if you are using the OpenGL layer (i.e., have called icetGLInitialize), these options, defined in IceTGL.h, are also avail- able. ICET_GL_DISPLAY If enabled, the final, composited image for each tile is written back to the frame buffer before the return of icetGLDrawFrame. This flag is enabled by default. ICET_GL_DISPLAY_COLORED_BACKGROUND If this and ICET_GL_DISPLAY are enabled, IceT uses OpenGL blending to ensure that all background is set to the correct color. This flag is disabled by default. This option does not affect the images returned from icetGLDrawFrame; it only affects the image in the OpenGL color buffer. ICET_GL_DISPLAY_INFLATE If this and ICET_GL_DISPLAY are enabled and the renderable window is larger than the displayed tile (as determined by the current OpenGL viewport), then resample the image to fit within the renderable window before writing back to frame buffer. This flag is dis- abled by default. This option does not affect the images returned from icetGLDrawFrame; it only affects the image in the OpenGL color buffer. If this option is not enabled, then images are written at their natural size in the lower left corner of the window. ICET_GL_DISPLAY_INFLATE_WITH_HARDWARE This option determines how images are inflated. When enabled (the default), images are inflated by creating a texture and allowing the hardware to inflate the image. When disabled, images are inflated on the CPU. This option has no effect unless both ICET_GL_DIS- PLAY and ICET_GL_DISPLAY_INFLATE are also enabled. Errors ICET_INVALID_VALUE If pname is not a feature to be enabled or disabled. Warnings None. Bugs The check for a valid pname is not thorough, and thus the ICET_INVALID_VALUE error may not always be raised. 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 icetIsEnabled(3) IceT Reference July 11, 2011 icetEnable(3)