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
written 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
geometry 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.
See Also
icetIsEnabled(3)
IceT Reference May 23, 2006 icetEnable(3)