icetEnable(3)
NAME
icetEnable,icetDisable-- enable/disable an IceT feature.
Synopsis
#include <GL/ice-t.h>
void icetEnable ( GLenum pname );
void icetDisable ( GLenum 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_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_DISPLAY
- If enabled, the final, composited image for each tile is writ
- ten back to the frame buffer before the return of icetDrawFrame. This flag is enabled by default.
- ICET_DISPLAY_COLORED_BACKGROUND
- If this and ICET_DISPLAY are enabled, 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 icetGetColorBufferor icetGetDepthBuffer;it only affects the image in the OpenGL color buffer.
- ICET_DISPLAY_INFLATE
- If this and ICET_DISPLAY are enabled and the renderable window
- is larger then 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 disabled by default. This option does not affect the images returned from icetGetColorBufferor icetGetDepthBuffer;it only affects the image in the OpenGL color buffer.
- ICET_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 the inflate the image. When disabled, images are inflated on the CPU. This option has no effect unless both ICET_DISPLAY and ICET_DISPLAY_INFLATE are also enabled.
- ICET_FLOATING_VIEWPORT
- If enabled, the projection will be shifted such that the geome
- try will be rendered in one shot whenever possible, even if the geometry straddles up to four tiles. 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 compositing 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.
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, there is a non-exclusive
license for use of this work by or on behalf of the U.S. Government.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that this Notice and any statement of
authorship are reproduced on all copies.